డెవలపర్ డాక్యుమెంటేషన్

ఈ వ్యవస్థను టెక్ ప్యాడ్ API.

మీ స్వంత వ్యవస్థల నుండి వాట్సాప్ టెంప్లేట్ సందేశాలను పంపండి, వెబ్ హుక్ ద్వారా డెలివరీ సంఘటనలను స్వీకరించండి మరియు లాగ్లలోని ప్రతి అభ్యర్థనను పర్యవేక్షించండి.

ఉచిత WordPress ప్లగిన్లు

కోడ్ను దాటవేయండి కనెక్టర్ ప్లగ్ఇన్ను ఇన్స్టాల్ చేయండి.

అదే వాట్సాప్ బిజినెస్ API, మీరు ఇప్పటికే ఉపయోగించే సాధనాల కోసం ఉచిత కనెక్టర్ ప్లగిన్లతో ముడుచుకున్న ప్రతి ఫారం, బుకింగ్, ఈవెంట్ మరియు స్టోర్ ప్లాట్ఫాం మీ వాట్సాప్కు నేరుగా పంపుతుంది. ఇన్స్టాల్ చేయండి, మీ ఇమెయిల్తో కనెక్ట్ అవ్వండి, పూర్తయింది.

వేగంగా ప్రారంభం

0 నుండి నాలుగు దశల్లో పంపిన వాట్సాప్ సందేశానికి. ఇక్కడ ప్రతిదీ అనువర్తనాల్లో కూడా పనిచేస్తుంది డెవలపర్లు → అవలోకనం పేజీ, మీ పురోగతిని ట్రాక్ చేస్తుంది.

1

API కీని సృష్టించు

తెరిచి డెవలపర్లు → API కీలు అనువర్తనంలో మరియు ఒక కీ సృష్టించు (ప్రెఫిక్స్ ttp_live_) పూర్తి రహస్యం వెల్లడించింది ఒకసారి వెంటనే దాన్ని కాపీ చేయండి.

2

ఆమోదించబడిన టెంప్లేట్ను ఎంచుకోండి

మీ వర్క్ స్పేస్కు కనీసం ఒక మెటా-ఆధారిత టెంప్లేట్ అవసరం (చూడండి టెంప్లేట్లు) టెంప్లేట్లు నేరుగా మెటా నుండి రిఫ్రెష్.

3

పరీక్షా అభ్యర్థనను పంపండి

అనువర్తనంలో ఉపయోగించండి ఎపిఐ టెస్టర్ మీ నెంబర్ నుండి టెంప్లేట్ సందేశాలను స్వీకరించడానికి గ్రహీత ఎంపిక చేసుకోవాలి.

4

డెలివరీ వెబ్ హుక్ను జోడించండి

మీ HTTPS ఎండ్ పాయింట్కు వెబ్ హుక్ను దర్శకత్వం వహించండి, మీకు ఆసక్తి ఉన్న సంఘటనలను ఎంచుకోండి, మరియు చూడండి వెబ్ హుక్ లాగ్లు డెలివరీని నిర్ధారించండి.

ధృవీకరణ

API ని వర్క్ స్పేస్కు API కీలతో ధృవీకరించబడుతుంది. కీలను బేరర్ టోకెన్గా పంపబడుతుంది. కీలను సృష్టించి, రద్దు చేస్తారు డెవలపర్లు → API కీలు.

  • కీలు ప్రారంభం ttp_live_ మరియు ఒక పని ప్రదేశానికి పరిమితం చేయబడ్డాయి.
  • ప్రతి ఇంటిగ్రేషన్కు ప్రత్యేక కీని సృష్టించండి ప్రతి కీ దాని స్వంత ట్రాక్లను కలిగి ఉంటుంది 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

అభ్యర్థన సంస్థ

క్షేత్రంరకంవివరణ
phoneNumberIdకణముమీ కార్యాలయంలో కనెక్ట్ చేయబడిన వాట్సాప్ నంబర్ ID (వాట్సాప్ నంబర్ల పేజీ).
toకణముE.164 ఫార్మాట్ లోని గ్రహీత ఫోన్ నంబర్, ఉదాహరణకు 15551234567.
template.nameకణముమీ వర్క్ స్పేస్ లో మెటా-ఆమోదించిన టెంప్లేట్ పేరు, ఉదాహరణకు order_update.
template.languageకణముటెంప్లేట్ భాష కోడ్, ఉదాహరణకు en.
template.parametersశ్రేణి<string>టెంప్లేట్ s వేరియబుల్స్ కోసం స్థాన విలువలు, క్రమంలో.

ఉదాహరణ అభ్యర్థన

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వాట్సాప్ ప్లాట్ఫామ్ ఒక సందేశాన్ని అంగీకరించింది.
message.deliveredసందేశం గ్రహీత పరికరానికి పంపబడింది.
message.readఅందుకున్నవారు సందేశాన్ని చదివారు.
message.failedసందేశం విఫలమైంది (అనర్గణించలేనిది, టెంప్లేట్ తిరస్కరించబడింది, పంపినవారి పరిమితి, . . .).
message.receivedఒక కస్టమర్ నుండి ఒక ఇన్బౌండ్ సందేశం వచ్చింది.
  • ఎండ్ పాయింట్స్ ఉండాలి HTTPS మరియు ఇంటర్నెట్ నుండి చేరుకోవచ్చు.
  • ప్రతి ఎండ్ పాయింట్ ఎంచుకున్న సంఘటనల ఉపసమితికి సభ్యత్వాన్ని ఇస్తుంది; ప్రతి సంఘటన సందేశ ఐడి మరియు స్థితిని కలిగి ఉన్న JSON పైల్ లోడ్తో ఫైర్ అవుతుంది.
  • ఉపయోగించడం పరీక్ష ఒక ఎండ్ పాయింట్ వద్ద నమూనా డెలివరీ పంపడానికి మరియు మీ హ్యాండిల్ ధృవీకరించడానికి.
  • విరామం ఉన్న ఎండ్ పాయింట్లు వాటి ఆకృతిని కలిగి ఉంటాయి కానీ సంఘటనలను స్వీకరించడం ఆగిపోతుంది.

రేటు పరిమితులు

మీ ప్లాన్ ప్యాకేజీ రేటు వరకు సందేశాలు పంపబడతాయి. మెటా సందేశ స్థాయి, ఫోన్ నాణ్యత లేదా ఖాతా స్థాయి పరిమితులను వర్తింపజేసినప్పుడు వాస్తవ ట్రావ్యూట్ తక్కువగా ఉంటుంది. సందేశాలు ఉంటాయి సురక్షితంగా క్యూలో విస్మరించబడటం కంటే.

ప్రణాళికఎపిఐ కాల్స్ / నెలబేస్ పంపే రేటు
ప్రచార ప్రారంభం—నిమిషానికి 6 సందేశాలు
ప్రయోగం10,000ప్యాకేజీ రేటు
పెరుగుదల200,000ప్యాకేజీ రేటు
స్కేల్2,000,000ప్యాకేజీ రేటు

ప్రతి అభ్యర్థన మీ API కాల్ కోటాకు లెక్కించబడుతుంది మరియు దాని స్థితి కోడ్ మరియు వ్యవధితో API లాగ్లలో నమోదు చేయబడుతుంది.

లాగ్స్ & పర్యవేక్షణ

డెవలపర్లు → లాగ్లు రెండు అభిప్రాయాలను కలిగి ఉందిః

  • ఎపిఐ లాగ్లు ప్రతి API అభ్యర్థనః పద్ధతి, ఎండ్ పాయింట్, HTTP స్థితి, ఉపయోగించిన టెంప్లేట్ మరియు వ్యవధి.
  • వెబ్ హుక్ లాగ్లు ప్రతి వెబ్ హుక్ డెలివరీ ప్రయత్నం మరియు దాని ఫలితం.

వాటిని ఉపయోగించి విఫలమైన పంపిణీలను డీబగ్ చేయడానికి, వెబ్ హుక్ డెలివరీని నిర్ధారించడానికి మరియు ముగింపు నుండి ముగింపు వరకు ఆడిట్ ఇంటిగ్రేషన్లను నిర్వహించడానికి.

తప్పులు

విజయవంతమైన అభ్యర్థనలు తిరిగి 2xx స్థితి. సమస్యను వివరించే JSON శరీరంతో non-2xx స్థితిని తిరిగి ఇవ్వడంలో వైఫల్యాలుః

{
  "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 ను ఉత్పత్తి చేస్తుంది.

మాతో చాట్