ఈ వ్యవస్థను టెక్ ప్యాడ్ API.
మీ స్వంత వ్యవస్థల నుండి వాట్సాప్ టెంప్లేట్ సందేశాలను పంపండి, వెబ్ హుక్ ద్వారా డెలివరీ సంఘటనలను స్వీకరించండి మరియు లాగ్లలోని ప్రతి అభ్యర్థనను పర్యవేక్షించండి.
కోడ్ను దాటవేయండి కనెక్టర్ ప్లగ్ఇన్ను ఇన్స్టాల్ చేయండి.
అదే వాట్సాప్ బిజినెస్ API, మీరు ఇప్పటికే ఉపయోగించే సాధనాల కోసం ఉచిత కనెక్టర్ ప్లగిన్లతో ముడుచుకున్న ప్రతి ఫారం, బుకింగ్, ఈవెంట్ మరియు స్టోర్ ప్లాట్ఫాం మీ వాట్సాప్కు నేరుగా పంపుతుంది. ఇన్స్టాల్ చేయండి, మీ ఇమెయిల్తో కనెక్ట్ అవ్వండి, పూర్తయింది.
వేగంగా ప్రారంభం
0 నుండి నాలుగు దశల్లో పంపిన వాట్సాప్ సందేశానికి. ఇక్కడ ప్రతిదీ అనువర్తనాల్లో కూడా పనిచేస్తుంది డెవలపర్లు → అవలోకనం పేజీ, మీ పురోగతిని ట్రాక్ చేస్తుంది.
API కీని సృష్టించు
తెరిచి డెవలపర్లు → API కీలు అనువర్తనంలో మరియు ఒక కీ సృష్టించు (ప్రెఫిక్స్ ttp_live_) పూర్తి రహస్యం వెల్లడించింది ఒకసారి వెంటనే దాన్ని కాపీ చేయండి.
ఆమోదించబడిన టెంప్లేట్ను ఎంచుకోండి
మీ వర్క్ స్పేస్కు కనీసం ఒక మెటా-ఆధారిత టెంప్లేట్ అవసరం (చూడండి టెంప్లేట్లు) టెంప్లేట్లు నేరుగా మెటా నుండి రిఫ్రెష్.
పరీక్షా అభ్యర్థనను పంపండి
అనువర్తనంలో ఉపయోగించండి ఎపిఐ టెస్టర్ మీ నెంబర్ నుండి టెంప్లేట్ సందేశాలను స్వీకరించడానికి గ్రహీత ఎంపిక చేసుకోవాలి.
డెలివరీ వెబ్ హుక్ను జోడించండి
మీ HTTPS ఎండ్ పాయింట్కు వెబ్ హుక్ను దర్శకత్వం వహించండి, మీకు ఆసక్తి ఉన్న సంఘటనలను ఎంచుకోండి, మరియు చూడండి వెబ్ హుక్ లాగ్లు డెలివరీని నిర్ధారించండి.
ధృవీకరణ
API ని వర్క్ స్పేస్కు API కీలతో ధృవీకరించబడుతుంది. కీలను బేరర్ టోకెన్గా పంపబడుతుంది. కీలను సృష్టించి, రద్దు చేస్తారు డెవలపర్లు → API కీలు.
- కీలు ప్రారంభం
ttp_live_మరియు ఒక పని ప్రదేశానికి పరిమితం చేయబడ్డాయి. - ప్రతి ఇంటిగ్రేషన్కు ప్రత్యేక కీని సృష్టించండి ప్రతి కీ దాని స్వంత ట్రాక్లను కలిగి ఉంటుంది
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 | కణము | మీ కార్యాలయంలో కనెక్ట్ చేయబడిన వాట్సాప్ నంబర్ 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 ను ఉత్పత్తి చేస్తుంది.