டெவலப்பர் ஆவணங்கள்

உருவாக்கவும் டெக் பேட் API இல்.

உங்கள் சொந்த சிஸ்டங்கள் மூலம் WhatsApp கொள்ளப்பட்ட மெசேஜ்களை அனுப்புக, webhook மூலம் டெலிவரி நிகழ்வுகளை பெறுக மற்றும் அனைத்து கோரிக்கைகளையும் பதிவுகளில் கண்காணிக்கவும்.

இலவச WordPress பிளக்கின்கள்

கோடை தவிர்க்கவும் — ஒரு இணைப்புக்கான பிளக்கினை நிறுவவும்.

நீங்கள் 이미 பயன்படுத்தும் கருவிகளுக்காக இலவச இணைப்புப் பிளக்கின்களாக கேள்வி வணிக API — ஒவ்வொரு படிவம், முன்பதிவு, நிகழ்ச்சி மற்றும் கடை தளம் நேரடியாக உங்கள் WhatsAppக்கு அனுப்புகிறது. நிறுவவும், உங்கள் மின்னஞ்சலுடன் இணைக்கவும், முடிந்தது.

விரைவு தொடக்கம்

நான்கு படிகளில் பூஜ்ஜிய நிலையில் இருந்து ஒரு டெலிவரி செய்யப்பட்ட WhatsApp செய்திக்கு. இங்கு உள்ள அனைத்தும் செயலியில் உள்ளவையாகவும் வேலை செய்கின்றன தயாரிப்பாளர்கள் → கண்ணோட்டம் பக்கம், இது உங்கள் முன்னேற்றத்தை கண்காணிக்கிறது.

1

ஒரு API விசையை உருவாக்கு

திற தயாரிப்பாளர்கள் → API விசைகள் செயலியில் திறந்து ஒரு விசையை உருவாக்கவும் (முன்னொட்டு ttp_live_). முழு ரகசியம் ஒருமுறை காட்டப்படும் — அதை உடனே நகலெடுக்கவும்.

2

அங்கீகாரம் பெற்ற வார்ப்புருவை தேர்ந்தெடுக்கவும்

உங்கள் பணிமனைக்கு குறைந்தது ஒரு மெட்டா-அங்கீகாரம் பெற்ற திட்டச்செருகல் தேவை (காண்க முழுமைகள்). மாதிரிகள் நேரடியாக மெட்டாவிலிருந்து புதுப்பிக்கப்படுகின்றன.

3

ஒரு பரிசோதனை கோரிக்கையை அனுப்புக

ஆப் உள்ளே பயன்படுத்தவும் API சோதகர் அல்லது கீழுள்ள கோரிக்கைக்கு. பெறுநர் உங்கள் எண்ணிலிருந்து வடிவமைப்பு மெசேஜ்களை பெற தெரிவுசெய்திருக்க வேண்டும்.

4

ஒரு டெலிவரி வெப்பூக் சேர்க்கவும்

உங்கள் HTTPS முடிவுகளை ஒரு வலைஹுக் நோக்கிச் செஞ்சு, நீங்கள் கவலைப்படுகிற நிகழ்வுகளை தேர்ந்தெடுத்து, பார்க்கவும் வெப்புக் பதிவு விநியோகத்தை հաստատிக்கவும்.

அங்கீகாரம்

API ஒவ்வொரு வேலைப்பாட்டிற்குமான API விசைகளுடன் அனுமதிக்கப்பட்டுள்ளது, இது ஒரு பேயர் டோகனாக அனுப்பப்படுகிறது. விசைகள் உருவாக்கப்படுகின்றன மற்றும் ரத்து செய்யப்படுகின்றன தயாரிப்பாளர்கள் → API விசைகள்.

  • விசைகள் இவை மூலம் துவங்குகின்றன ttp_live_ மற்றும் một வேலைய்நிறைவு மட்டுமே உள்ளடக்கியவை.
  • ஒவ்வொரு இணைப்பிற்கும் தனித்தனி விசையை உருவாக்கவும் — ஒவ்வொரு விசையும் தன்னுடைய last used காலஅளவை பதிவு செய்கிறது.
  • முழு ரகசியம் உருவாக்கப்படும் போது ஒருமுறை மட்டுமே காட்டப்படும்; பின்னர் மீட்க முடியாது. பதிலாக, ரத்து செய்து மீண்டும் உருவாக்கவும்.
  • விசையை அனுப்பவும் Authorization தலைப்பில்: Authorization: Bearer ttp_live_…
உங்கள் API விசையை எப்பொழுதும் வெளிப்படுத்தாதீர்கள் கஸ்டமர்-சைடு கோடு, மொபைல் செயலிகள் அல்லது பொதுவான சேமிப்பகங்களில். விசைகள் உங்கள் சொந்த சேவையகங்கள் மற்றும் பாதுகாப்பு பின்புறங்களுக்கே பொருந்தும்.

ஒரு செய்தி அனுப்பவும்

உங்கள் வேலைப்பலகையில் இணைக்கப்பட்ட எண்ணிலிருந்து ஒப்புக்கொள்ளப்பட்ட ஒரே WhatsApp டெம்பிளேட் செய்தியை அனுப்புகிறது.

POST https://v1.thetechpad.com/functions/v1/api-send

தலைப்பு: Authorization: Bearer ttp_live_… · Content-Type: application/json

கோரிக்கை உடல்

புலம்வகைவிவரம்
phoneNumberIdstringஉங்கள் வேலைப்பலகையில் இணைக்கப்பட்ட WhatsApp எண்ணின் ஐடி (WhatsApp எண்கள் பக்கம்).
tostringஎதிர் போன் நம்பர் E.164 வடிவத்தில், உதாரணம்: 15551234567.
template.namestringஉங்கள் பணியிடத்தில் மெட்டா-அங்கீகாரம் பெற்ற வார்ப்புரு பெயர், உதாரணம்: order_update.
template.languagestringவார்ப்புரு மொழி குறியீடு, உதாரணம்: en.
template.parametersarray<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,000Package விகிதம்
வளர்ச்சி200,000Package விகிதம்
பெரிதாக்குங்கள்2,000,000Package விகிதம்

ஒவ்வொரு கோரிக்கையும் உங்கள் 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 உருவாக்கப்படுகிறது.

எங்களுடன் சந்திக்கவும்