डेव्हलपर दस्तऐवज

वर बांधा टेक पॅड API.

आपल्या स्वतःच्या प्रणालींमधून WhatsApp टेम्पलेट संदेश पाठवा, वेबहुकद्वारे वितरण घटना मिळवा आणि लॉगमध्ये प्रत्येक विनंतीचे निरीक्षण करा.

विनामूल्य वर्डप्रेस प्लगिन्स

कोड वगळा — कनेक्टर प्लगिन इंस्टॉल करा.

साचाच WhatsApp बिझनेस API, तुम्ही आधीच वापरत असलेल्या साधनांसाठी विनामूल्य कनेक्टर प्लगिन्समध्ये उपलब्ध — प्रत्येक फॉर्म, बुकिंग, इव्हेंट आणि स्टोअर प्लॅटफॉर्म थेट तुमच्या WhatsApp वर पाठवतो. इंस्टॉल करा, तुमच्या ईमेलसह कनेक्ट करा, झाले.

त्वरित प्रारंभ

शून्यातून चार टप्प्यात वितरित व्हाट्सअॅप संदेशापर्यंत. इथे सर्व काही अ‍ॅपमध्येही कार्य करते विकसक → आढावा पृष्ठ, जे तुमच्या प्रगतीचा मागोवा घेतो.

1

एपीआय की तयार करा

उघडा डेव्हलपर्स → API की अॅपमध्ये आणि की तयार करा (प्रिफिक्स ttp_live_). संपूर्ण रहस्य दाखवले आहे एकदा — त्वरित त्याची प्रत कॉपी करा.

2

मान्यताप्राप्त टेम्पलेट निवडा

तुमच्या कार्यक्षेत्राला किमान एक मेटा-मान्यताप्राप्त टेम्पलेट असणे आवश्यक आहे (पहा टेम्पलेट्स). टेम्पलेट्स थेट मेटा कडून रिफ्रेश होतात.

3

टेस्ट विनंती पाठवा

अॅपमध्ये वापरा API परीक्षक किंवा खालील विनंती वापरा. प्राप्तकर्त्याने तुमच्या क्रमांकावरून टेम्पलेट संदेश मिळवण्यासाठी नोंदणी केलेली असावी.

4

डिलिव्हरी वेबहुक जोडा

तुमच्या HTTPS एंडपॉइंटवर वेबहुक पॉइंट करा, तुम्हाला आवडणार्‍या इव्हेंट निवडा, आणि पहा Webhook लॉग्स वितरणाची पुष्टी करा.

प्रमाणीकरण

API ही पार्ट-वर्कस्पेस API कीजसह प्रमाणीकृत आहे जी बेअरर टोकन म्हणून पाठवली जातात. कीज तयार केल्या जातात आणि रद्द केल्या जातात डेव्हलपर्स → API की.

  • किज सुरू होतात ttp_live_ आणि एका वर्कस्पेसपुरती मर्यादित असतात.
  • प्रत्येक इंटिग्रेशनसाठी वेगळी की तयार करा — प्रत्येक की तिचा स्वतःचा last used टाइमस्टँप ट्रॅक करते.
  • पूर्ण सीक्रेट फक्त निर्माणाच्या वेळी एकदाच दर्शविला जातो; नंतर तो पुन्हा मिळवता येत नाही. त्याऐवजी रद्द करा आणि पुन्हा तयार करा.
  • की खालील हेडरमध्ये पाठवा: Authorization header: Authorization: Bearer ttp_live_…
आपला API की कधीही प्रकट करू नका क्लायंट-साइड कोड, मोबाइल अॅप्स किंवा सार्वजनिक रेपॉझिटरीमध्ये. की फक्त आपल्या स्वत: च्या सर्व्हर्स आणि सुरक्षित बॅकएंडसाठी असतात.

संदेश पाठवा

आपल्या कार्यक्षेत्रातील जोडलेल्या नंबरमधून एका ऑप्ट-इन रिसिपियंटला मंजूर केलेला WhatsApp टेम्पलेट संदेश पाठवते.

POST 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'] }
  })
});
टेम्प्लेट नियम लागू होतात. संदेश शक्यतो मंजूर केलेल्या साच्याचा वापर करावा आणि प्राप्तकर्ता पात्र (साइन अप केलेला) असावा. Meta प्रत्येक वितरित साचा संदेशाची पडताळणी करते आणि शुल्क घेतो — ही फी वेगळे Meta द्वारे बिल केली जाते, आपल्या Tech Pad योजनेबाहेर.

वेबहुक्स

आउटबाउंड वेबहुक्स संदेश जीवनचक्र घटना आपल्या 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 तयार करतो.

आमच्याशी चॅट करा