உருவாக்கவும் டெக் பேட் API இல்.
உங்கள் சொந்த சிஸ்டங்கள் மூலம் WhatsApp கொள்ளப்பட்ட மெசேஜ்களை அனுப்புக, webhook மூலம் டெலிவரி நிகழ்வுகளை பெறுக மற்றும் அனைத்து கோரிக்கைகளையும் பதிவுகளில் கண்காணிக்கவும்.
கோடை தவிர்க்கவும் — ஒரு இணைப்புக்கான பிளக்கினை நிறுவவும்.
நீங்கள் 이미 பயன்படுத்தும் கருவிகளுக்காக இலவச இணைப்புப் பிளக்கின்களாக கேள்வி வணிக API — ஒவ்வொரு படிவம், முன்பதிவு, நிகழ்ச்சி மற்றும் கடை தளம் நேரடியாக உங்கள் WhatsAppக்கு அனுப்புகிறது. நிறுவவும், உங்கள் மின்னஞ்சலுடன் இணைக்கவும், முடிந்தது.
விரைவு தொடக்கம்
நான்கு படிகளில் பூஜ்ஜிய நிலையில் இருந்து ஒரு டெலிவரி செய்யப்பட்ட WhatsApp செய்திக்கு. இங்கு உள்ள அனைத்தும் செயலியில் உள்ளவையாகவும் வேலை செய்கின்றன தயாரிப்பாளர்கள் → கண்ணோட்டம் பக்கம், இது உங்கள் முன்னேற்றத்தை கண்காணிக்கிறது.
ஒரு API விசையை உருவாக்கு
திற தயாரிப்பாளர்கள் → API விசைகள் செயலியில் திறந்து ஒரு விசையை உருவாக்கவும் (முன்னொட்டு ttp_live_). முழு ரகசியம் ஒருமுறை காட்டப்படும் — அதை உடனே நகலெடுக்கவும்.
அங்கீகாரம் பெற்ற வார்ப்புருவை தேர்ந்தெடுக்கவும்
உங்கள் பணிமனைக்கு குறைந்தது ஒரு மெட்டா-அங்கீகாரம் பெற்ற திட்டச்செருகல் தேவை (காண்க முழுமைகள்). மாதிரிகள் நேரடியாக மெட்டாவிலிருந்து புதுப்பிக்கப்படுகின்றன.
ஒரு பரிசோதனை கோரிக்கையை அனுப்புக
ஆப் உள்ளே பயன்படுத்தவும் API சோதகர் அல்லது கீழுள்ள கோரிக்கைக்கு. பெறுநர் உங்கள் எண்ணிலிருந்து வடிவமைப்பு மெசேஜ்களை பெற தெரிவுசெய்திருக்க வேண்டும்.
ஒரு டெலிவரி வெப்பூக் சேர்க்கவும்
உங்கள் HTTPS முடிவுகளை ஒரு வலைஹுக் நோக்கிச் செஞ்சு, நீங்கள் கவலைப்படுகிற நிகழ்வுகளை தேர்ந்தெடுத்து, பார்க்கவும் வெப்புக் பதிவு விநியோகத்தை հաստատிக்கவும்.
அங்கீகாரம்
API ஒவ்வொரு வேலைப்பாட்டிற்குமான API விசைகளுடன் அனுமதிக்கப்பட்டுள்ளது, இது ஒரு பேயர் டோகனாக அனுப்பப்படுகிறது. விசைகள் உருவாக்கப்படுகின்றன மற்றும் ரத்து செய்யப்படுகின்றன தயாரிப்பாளர்கள் → API விசைகள்.
- விசைகள் இவை மூலம் துவங்குகின்றன
ttp_live_மற்றும் một வேலைய்நிறைவு மட்டுமே உள்ளடக்கியவை. - ஒவ்வொரு இணைப்பிற்கும் தனித்தனி விசையை உருவாக்கவும் — ஒவ்வொரு விசையும் தன்னுடைய
last usedகாலஅளவை பதிவு செய்கிறது. - முழு ரகசியம் உருவாக்கப்படும் போது ஒருமுறை மட்டுமே காட்டப்படும்; பின்னர் மீட்க முடியாது. பதிலாக, ரத்து செய்து மீண்டும் உருவாக்கவும்.
- விசையை அனுப்பவும்
Authorizationதலைப்பில்:Authorization: Bearer ttp_live_…
ஒரு செய்தி அனுப்பவும்
உங்கள் வேலைப்பலகையில் இணைக்கப்பட்ட எண்ணிலிருந்து ஒப்புக்கொள்ளப்பட்ட ஒரே WhatsApp டெம்பிளேட் செய்தியை அனுப்புகிறது.
https://v1.thetechpad.com/functions/v1/api-send
தலைப்பு: Authorization: Bearer ttp_live_… · Content-Type: application/json
கோரிக்கை உடல்
| புலம் | வகை | விவரம் |
|---|---|---|
phoneNumberId | string | உங்கள் வேலைப்பலகையில் இணைக்கப்பட்ட WhatsApp எண்ணின் ஐடி (WhatsApp எண்கள் பக்கம்). |
to | string | எதிர் போன் நம்பர் E.164 வடிவத்தில், உதாரணம்: 15551234567. |
template.name | string | உங்கள் பணியிடத்தில் மெட்டா-அங்கீகாரம் பெற்ற வார்ப்புரு பெயர், உதாரணம்: order_update. |
template.language | string | வார்ப்புரு மொழி குறியீடு, உதாரணம்: en. |
template.parameters | array<string> | வார்ப்புருவின் மாறியல்களின் நிலைநிலை மதிப்புகள், வரிசைப்படி. |
உதாரண கோரிக்கை
curl -X POST 'https://v1.thetechpad.com/functions/v1/api-send' \ -H 'Authorization: Bearer ttp_live_...' \ -H 'Content-Type: application/json' \ -d '{ "phoneNumberId": "1122334455", "to": "15551234567", "template": { "name": "order_update", "language": "en", "parameters": ["Ava", "#4031"] } }'
// JavaScript
const response = await fetch('https://v1.thetechpad.com/functions/v1/api-send', {
method: 'POST',
headers: { Authorization: 'Bearer ttp_live_...', 'Content-Type': 'application/json' },
body: JSON.stringify({
phoneNumberId: '1122334455',
to: '15551234567',
template: { name: 'order_update', language: 'en', parameters: ['Ava', '#4031'] }
})
});
வெப் ஹூக்கள்
வெளியே செல்லும் வெப்பூக்கள் நெருக்கமாக ரியல் டைமில் உங்கள் HTTPS குறிச்சொற்சியில் செய்தி வாழ்நாள் நிகழ்வுகளை தள்ளுகின்றன. குறிச்சொற்சிகளை நிர்வகிக்க பெருவளர்கள் → வெப்பூக்கள் — சேர்க்க, தொகுக்க, இடைநிறுத்த, சோதனை செய்ய மற்றும் அழிக்க.
நிகழ்வுகள்
| நிகழ்வு | ஏற்கெனவே நடக்கும் போது |
|---|---|
message.sent | ஒரு செய்தி WhatsApp தளத்தால் ஏற்கப்பட்டது மற்றும் அனுப்பப்பட்டது. |
message.delivered | செய்தி பெறுநரின் சாதனத்திற்கு அனுப்பப்பட்டது. |
message.read | பெறுநர் அந்த செய்தியை வாசித்தார். |
message.failed | செய்தி தோல்வியுற்றது (அனுப்ப முடியாதது, மாதிரி நிராகரிக்கப்பட்டது, அனுப்புநர் வரம்பு, ...). |
message.received | ஒரு வாடிக்கையாளர் இருந்து உள்ளீட்டு செய்தி வந்தது. |
- முடackson்கள் இருக்க வேண்டும் HTTPS மற்றும் இணையத்திலிருந்து அணுகக்கூடியதாக இருக்க வேண்டும்.
- ஒவ்வொரு எண்ட்பாயின்டும் தேர்ந்தெடுக்கப்பட்ட நிகழ்வுகளின் ஒரு உபஸெட்டிற்கு சந்தாகிறது; ஒவ்வொரு நிகழ்வும் செய்திக் குறியீடு மற்றும் நிலை கொண்ட JSON பையில் துடிக்கிறது.
- பயன்பாடு சோதனை ஒரு எண்ட்பாயின்டில் மாதிரியான வழங்கலை அனுப்ப கேள்வி செய்யவும் உங்கள் ஹேண்ட்லரை சரிபார்க்கவும்.
- நிறுத்தப்பட்ட எண்ட்பாயின்டுகள் தங்கள் கட்டமைப்பை எங்கும் வைத்திருக்கும் ஆனால் நிகழ்வுகளை பெறுவதை நிறுத்துகின்றன.
விகிதக் கட்டுப்பாடுகள்
செய்திகள் உங்கள் திட்டத்தின் பேக்கேஜ் விகிதத்தில் அனுப்பப்படுகின்றன. மெட்டா மெசேஜிங்-அடுக்கு, தொலைபேசி-நிலை அல்லது கணக்கு-நிலை வரம்புகளை வகுப்பதால் உண்மையான திறன் குறைவாக இருக்கலாம். செய்திகள் தொடர்ந்தே பாதுகாப்பாக வரிசைப்படுத்தியது நீக்கப்படுவதைவிட.
| திட்டம் | மாதத்திற்கு API அழைப்புகள் | அடிப்படை அனுப்பும் விகிதம் |
|---|---|---|
| கேம்பெயின் ஸ்டார்டர் | — | நிமிடத்திற்கு 6 செய்திகள் வரை |
| லாஞ்ச் | 10,000 | Package விகிதம் |
| வளர்ச்சி | 200,000 | Package விகிதம் |
| பெரிதாக்குங்கள் | 2,000,000 | Package விகிதம் |
ஒவ்வொரு கோரிக்கையும் உங்கள் API-அழைப்பு குறியீட்டுக்கான அளவைக் கணக்கில் சேர்க்கப்படுகிறது மற்றும் அதன் நிலை குறியீடு மற்றும் கால அளவுடன் API பதிவுகளில் பதிவு செய்யப்படுகிறது.
பதிவுகள் மற்றும் கண்காணிப்பு
முன்னெடுப்பாளர்கள் → பதிவுகள் இரு பார்வைகளையும் பாதுகாக்கிறது:
- API பதிவுகள் — ஒவ்வொரு API கோரிக்கையும்: முறை, இறுதி புள்ளி, HTTP நிலை, பயன்படுத்தப்பட்ட மாதிரி மற்றும் கால அளவு.
- வெப்புக் பதிவு — ஒவ்வொரு webhook வழங்கல் முயற்சியும் அதன் முடிவும்.
போன அனுப்புதல்களை டிபக் செய்ய, webhook வழங்கலை உறுதிப்படுத்த மற்றும் ஒருமுறை முழுமையான ஒருங்கிணைப்புகளை பரிசோதிக்க அவற்றைப் பயன்படுத்தவும்.
பிழைகள்
வெற்றிகரமான கோரிக்கைகள் ஒரு 2xx நிலை திருப்புகின்றன. தோல்விகள் ஒரு non-2xx நிலையை JSON உட்கூறுடன் பிரச்சினையை விவரிக்கின்றன:
{
"error": "Template not approved",
"hint": "Check the template status in Templates — only APPROVED templates can be sent."
}
| நிலை | பொருள் |
|---|---|
2xx | கோரிக்கை ஏற்றுக்கொள்ளப்பட்டது / செயலாக்கப்பட்டது. |
400 | தவறான கோரிக்கை — காணப்படாத அல்லது தவறான புலங்கள். |
401 | காணப்படாத அல்லது தவறான API விசை. |
403 | இந்த நடவடிக்கை அல்லது பணிச்சூழலுக்கு செல்லுபடியான முக்கியம் ஆனால் அனுமதிக்கப்படவில்லை. |
404 | தெரியாத எண், வார்ப்புரு அல்லது வளம். |
429 | வரைவு அல்லது ஒதுக்கீடு மீறப்பட்டது — பின்னர் மீண்டும் முயற்சி செய்யவும். |
5xx | விளைப்பு செயலியில் பிழை — மீண்டும் முயற்சி செய்யவும்; API பதிவுகள் மற்றும் நிலை பக்கத்தை பார்க்கவும். |
கட்டளைப்பேட்டியிலிருந்து API ஐ முயற்சிக்கவும்.
நிரலைச் சேர்ந்த உள்ளமைப்பு API சோதகரை பயன்படுத்தி ஒவ்வொரு கோரிக்கைக்கும் curl, JavaScript மற்றும் PHP உருவாக்கப்படுகிறது.