वर बांधा टेक पॅड API.
आपल्या स्वतःच्या प्रणालींमधून WhatsApp टेम्पलेट संदेश पाठवा, वेबहुकद्वारे वितरण घटना मिळवा आणि लॉगमध्ये प्रत्येक विनंतीचे निरीक्षण करा.
कोड वगळा — कनेक्टर प्लगिन इंस्टॉल करा.
साचाच WhatsApp बिझनेस API, तुम्ही आधीच वापरत असलेल्या साधनांसाठी विनामूल्य कनेक्टर प्लगिन्समध्ये उपलब्ध — प्रत्येक फॉर्म, बुकिंग, इव्हेंट आणि स्टोअर प्लॅटफॉर्म थेट तुमच्या WhatsApp वर पाठवतो. इंस्टॉल करा, तुमच्या ईमेलसह कनेक्ट करा, झाले.
त्वरित प्रारंभ
शून्यातून चार टप्प्यात वितरित व्हाट्सअॅप संदेशापर्यंत. इथे सर्व काही अॅपमध्येही कार्य करते विकसक → आढावा पृष्ठ, जे तुमच्या प्रगतीचा मागोवा घेतो.
एपीआय की तयार करा
उघडा डेव्हलपर्स → API की अॅपमध्ये आणि की तयार करा (प्रिफिक्स ttp_live_). संपूर्ण रहस्य दाखवले आहे एकदा — त्वरित त्याची प्रत कॉपी करा.
मान्यताप्राप्त टेम्पलेट निवडा
तुमच्या कार्यक्षेत्राला किमान एक मेटा-मान्यताप्राप्त टेम्पलेट असणे आवश्यक आहे (पहा टेम्पलेट्स). टेम्पलेट्स थेट मेटा कडून रिफ्रेश होतात.
टेस्ट विनंती पाठवा
अॅपमध्ये वापरा API परीक्षक किंवा खालील विनंती वापरा. प्राप्तकर्त्याने तुमच्या क्रमांकावरून टेम्पलेट संदेश मिळवण्यासाठी नोंदणी केलेली असावी.
डिलिव्हरी वेबहुक जोडा
तुमच्या HTTPS एंडपॉइंटवर वेबहुक पॉइंट करा, तुम्हाला आवडणार्या इव्हेंट निवडा, आणि पहा Webhook लॉग्स वितरणाची पुष्टी करा.
प्रमाणीकरण
API ही पार्ट-वर्कस्पेस API कीजसह प्रमाणीकृत आहे जी बेअरर टोकन म्हणून पाठवली जातात. कीज तयार केल्या जातात आणि रद्द केल्या जातात डेव्हलपर्स → API की.
- किज सुरू होतात
ttp_live_आणि एका वर्कस्पेसपुरती मर्यादित असतात. - प्रत्येक इंटिग्रेशनसाठी वेगळी की तयार करा — प्रत्येक की तिचा स्वतःचा
last usedटाइमस्टँप ट्रॅक करते. - पूर्ण सीक्रेट फक्त निर्माणाच्या वेळी एकदाच दर्शविला जातो; नंतर तो पुन्हा मिळवता येत नाही. त्याऐवजी रद्द करा आणि पुन्हा तयार करा.
- की खालील हेडरमध्ये पाठवा:
Authorizationheader:Authorization: Bearer ttp_live_…
संदेश पाठवा
आपल्या कार्यक्षेत्रातील जोडलेल्या नंबरमधून एका ऑप्ट-इन रिसिपियंटला मंजूर केलेला WhatsApp टेम्पलेट संदेश पाठवते.
https://v1.thetechpad.com/functions/v1/api-send
हेडर: Authorization: Bearer ttp_live_… · Content-Type: application/json
विनंती बॉडी
| फील्ड | प्रकार | वर्णन |
|---|---|---|
phoneNumberId | स्ट्रिंग | आपल्या कार्यक्षेत्रातील जोडलेल्या WhatsApp नंबरचा आयडी (WhatsApp नंबर पृष्ठ). |
to | स्ट्रिंग | प्राप्तकर्ता फोन नंबर E.164 फॉरमॅटमध्ये, उदा. 15551234567. |
template.name | स्ट्रिंग | तुमच्या वर्कस्पेसमधील मेटा-मान्यताप्राप्त टेम्प्लेटचे नाव, उदा. order_update. |
template.language | स्ट्रिंग | टेम्प्लेट भाषा कोड, उदा. en. |
template.parameters | अॅरे<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 एंडपॉइंटवर जवळजवळ रिअल टाइममध्ये ढकलतात. एंडपॉइंट व्यवस्थापित करा Developers → Webhooks — जोडणे, संपादित करणे, थांबवणे, तपासणे आणि हटवणे.
इव्हेंट्स
| इव्हेंट | जेव्हा चालते |
|---|---|
message.sent | व्हाट्सअॅप प्लॅटफॉर्मने एक संदेश स्वीकारला आणि पाठविला. |
message.delivered | संदेश प्राप्तकर्त्याच्या डिव्हाइसवर पोहोचला. |
message.read | प्राप्तकर्त्याने संदेश वाचला. |
message.failed | संदेश अपयशी ठरला (पोहोचवता आले नाही, टेम्पलेट नाकारले गेले, पाठवणाऱ्याची मर्यादा, …). |
message.received | ग्राहकाकडून एक इनबाउंड संदेश आला. |
- एंडपॉइंट्स असणे आवश्यक आहे HTTPS आणि इंटरनेटवरून पोहोचता येण्याजोगे.
- प्रत्येक एंडपॉइंट निवडलेल्या घटना उपसदस्यतेला सबस्क्राइब करतो; प्रत्येक घटना JSON पेलोडसह फायर होते ज्यात संदेश आयडी आणि स्थिती असते.
- वापरा चाचणी करा एंडपॉइंटवर नमुना डिलिव्हरी पाठवण्यासाठी आणि तुमचा हॅंडलर तपासण्यासाठी.
- थांबविलेले एंडपॉइंट त्यांच्या कॉन्फिगरेशनला ठेवतात पण घटना मिळवणे थांबवतात.
दर मर्यादा
संदेश तुमच्या प्लॅनच्या पॅकेज दरावर पाठवले जातात. वास्तविक थ्रूपुट कमी असू शकते जेव्हा मेटा मेसेजिंग-टियर, फोन-गुणवत्ता किंवा अकाउंट-लेवल मर्यादा लागू करतो. संदेश राहतात सुरक्षितपणे रांगेत ठेवले विलंब न करता नष्ट होण्याऐवजी.
| योजना | API कॉल्स / महिना | मूलभूत पाठविण्याचे दर |
|---|---|---|
| कॅम्पेन स्टार्टर | — | दर मिनिटाला 6 संदेशांपर्यंत |
| लाँच | 10,000 | पॅकेज दर |
| वाढवा | 200,000 | पॅकेज दर |
| स्केल | 2,000,000 | पॅकेज दर |
प्रत्येक विनंती आपल्या API-कॉल कोटामध्ये गणली जाते आणि तिच्या स्थिती कोड आणि कालावधीसह API लॉगमध्ये नोंदवली जाते.
नोंदी व निरीक्षण
विकसक → लॉग्स दोन दृश्ये ठेवते:
- API लॉग्स — प्रत्येक API विनंती: पद्धत, एंडपॉईंट, HTTP स्थिती, वापरलेले टेम्पलेट आणि कालावधी.
- Webhook लॉग्स — प्रत्येक वेबहूक वितरणाचा प्रयत्न आणि त्याचे परिणाम.
अयशस्वी पाठवण्या डीबग करण्यासाठी, वेबहूक वितरणाची पुष्टी करण्यासाठी आणि एन्ड टू एन्ड इंटिग्रेशन तपासणीसाठी त्यांचा वापर करा.
चुका
यशस्वी विनंत्या एक 2xx स्थिती परत करतात. अयशस्वी विनंत्या 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 तयार करतो.