पर बनाएं टेक पैड एपीआई।

त्वरित शुरुआत

शून्य से चार चरणों में एक डिलीवर किए गए व्हाट्सएप संदेश तक। यहाँ सब कुछ ऐप के अंदर भी काम करता है डेवलपर्स → अवलोकन पृष्ठ, जो आपकी प्रगति को ट्रैक करता है।

प्रमाणीकरण

एपीआई प्रति-वर्कस्पेस एपीआई कुंजियों के साथ प्रमाणित है जो बियरर टोकन के रूप में भेजी जाती हैं। कुंजी बनाई जाती हैं और रद्द की जाती हैं डेवलपर्स → एपीआई कुंजियाँ.

• कुंजी से शुरू होती हैं ttp_live_ और इन्हें केवल एक वर्कस्पेस के लिए स्कोप किया गया है।
• प्रत्येक इंटीग्रेशन के लिए अलग कुंजी बनाएं — प्रत्येक कुंजी अपनी last used टाइमस्टैम्प को ट्रैक करती है।
• पूरा गुप्त केवल निर्माण के समय दिखाया जाता है; इसे बाद में पुनर्प्राप्त नहीं किया जा सकता। इसके बजाय रद्द करें और पुनः बनाएं।
• कुंजी को Authorization हेडर में भेजें: Authorization: Bearer ttp_live_…

संदेश भेजें

कनेक्टेड नंबर से एक स्वीकृत WhatsApp टेम्पलेट संदेश भेजता है, केवल उस प्राप्तकर्ता को जिसने अनुमति दी हो, जो आपके कार्यक्षेत्र में है।

रिक्वेस्ट बॉडी

उदाहरण अनुरोध

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 एंडपॉइंट पर लगभग वास्तविक समय में पुश करते हैं। एंडपॉइंट्स का प्रबंध करें डेवलपर्स → वेबहुक्स — जोड़ें, संपादित करें, रोकें, परीक्षण करें और हटाएं।

घटनाएँ

• एंडपॉइंट्स होने चाहिए HTTPS और इंटरनेट से पहुँचने योग्य।
• प्रत्येक एंडपॉइंट चुने गए इवेंट्स के उपस्ट्रियों का अनुसरण करता है; हर इवेंट में संदेश आईडी और स्थिति वाला JSON पेलोड होता है।
• उपयोग करें टेस्ट किसी एंडपॉइंट पर सैंपल डिलीवरी भेजने और अपने हैंडलर को सत्यापित करने के लिए।
• रुके हुए एंडपॉइंट अपनी कॉन्फ़िगरेशन बनाए रखते हैं लेकिन इवेंट्स प्राप्त करना बंद कर देते हैं।

दर सीमाएँ

संदेश आपके प्लान की पैकेज दर तक भेजे जाते हैं। वास्तविक थ्रूपुट कम हो सकता है जब Meta मैसेजिंग-स्तर, फोन-गुणवत्ता या खाता-स्तरीय सीमाओं को लागू करता है। संदेश बने रहते हैं सुरक्षित रूप से कतारबद्ध किया गया फेंकने के बजाय।

हर अनुरोध आपकी API-कॉल कोटा में गिना जाता है और इसे API लॉग में इसके स्थिति कोड और अवधि के साथ रिकॉर्ड किया जाता है।

लॉग और निगरानी

डेवलपर्स → लॉग दो दृश्य रखता है:

• API लॉग — हर API अनुरोध: विधि, एंडपॉइंट, HTTP स्थिति, उपयोग किए गए टेम्पलेट और अवधि।
• वेबहुक लॉग — प्रत्येक वेबहुक डिलीवरी प्रयास और उसका परिणाम।

इन्हें असफल भेजने की समस्याओं को डिबग करने, वेबहुक डिलीवरी की पुष्टि करने और एंटीग्रेशनों का एंड-टू-एंड ऑडिट करने के लिए उपयोग करें।

त्रुटियाँ

सफल अनुरोध एक 2xx स्थिति लौटाते हैं। असफलताओं में एक गैर-2xx स्थिति लौटती है जिसमें समस्या का विवरण देने वाला JSON बॉडी होता है:

{
  "error": "Template not approved",
  "hint": "Check the template status in Templates — only APPROVED templates can be sent."
}