اس پر تعمیر کریں ٹیک پیڈ API۔

فوری شروع

چار مراحل میں صفر سے ایک ڈیلیور شدہ واٹس ایپ پیغام تک۔ یہاں سب کچھ ایپ کے اندر بھی کام کرتا ہے ڈویلپرز → جائزہ صفحہ، جو آپ کی پیشرفت کو ٹریک کرتا ہے۔

تصدیق

API کو ہر ورک اسپیس کے API کیز کے ساتھ مستند بنایا جاتا ہے جو بیئرر ٹوکن کے طور پر بھیجی جاتی ہیں۔ کیز تخلیق اور منسوخ کی جاتی ہیں ڈویلپرز → API کلیدیں.

• چابیاں شروع ہوتی ہیں ttp_live_ اور ایک ورک اسپیس تک محدود ہیں۔
• ہر انٹیگریشن کے لیے الگ کلید بنائیں — ہر کلید اپنی خود کی نگرانی کرتی ہے last used ٹائم اسٹیمپ۔
• پورا راز صرف تخلیق کے وقت ہی دکھایا جاتا ہے؛ اسے بعد میں بازیافت نہیں کیا جا سکتا۔ اس کی بجائے منسوخ کریں اور دوبارہ تخلیق کریں۔
• چابی بھیجیں Authorization ہیڈر: Authorization: Bearer ttp_live_…

پیغام بھیجیں

اپنے ورک اسپیس کے جڑے ہوئے نمبر سے ایک منظوری شدہ واٹس ایپ ٹیمپلیٹ پیغام اس وصول کنندہ کو بھیجتا ہے جو عضو بن چکا ہو۔

درخواست کا مواد

درخواست کی مثال

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 — شامل کریں، ترمیم کریں، روکیں، ٹیسٹ کریں اور حذف کریں۔

ایونٹس

• اینڈپوائنٹس ہونے چاہئیں HTTPS اور انٹرنیٹ سے قابل رسائی۔
• ہر اینڈپوائنٹ منتخب کردہ ایونٹس کے ایک ذیلی سیٹ کو سبسکرائب کرتا ہے؛ ہر ایونٹ ایک JSON پی لوڈ کے ساتھ فائر ہوتا ہے جس میں میسج آئی ڈی اور اسٹیٹس شامل ہوتا ہے۔
• استعمال کریں ٹیسٹ کریں کسی اینڈپوائنٹ پر ایک سیمپل ڈیلیوری بھیجنے کے لیے اور اپنے ہینڈلر کی جانچ کرنے کے لیے۔
• معطل شدہ اینڈپوائنٹس اپنی کنفیگریشن برقرار رکھتے ہیں لیکن ایونٹس وصول کرنا بند کر دیتے ہیں۔

ریٹ کی حدیں

پیغامات آپ کے پلان کے پیکیج ریٹ پر بھیجے جاتے ہیں۔ حقیقی تھروپوٹ کم ہو سکتی ہے جب میٹا میسجنگ-ٹیئر، فون-کوالٹی یا اکاؤنٹ سطح کی حدود لاگو کرتا ہے۔ پیغامات باقی رہتے ہیں محفوظ طریقے سے قطار میں رکھا گیا بجائے اس کے کہ ضائع ہو جائے.

ہر درخواست آپ کے 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."
}