ابنِ على واجهة برمجة تطبيقات Tech Pad.

البدء السريع

من الصفر إلى رسالة واتساب مرسلة في أربع خطوات. كل شيء هنا يعمل أيضًا داخل التطبيق المطورون → نظرة عامة صفحة، التي تتبع تقدمك.

المصادقة

يتم مصادقة واجهة برمجة التطبيقات باستخدام مفاتيح واجهة برمجة التطبيقات الخاصة بكل مساحة عمل والتي تُرسل كرمز حامل. يتم إنشاء المفاتيح وإلغاؤها من المطورون → مفاتيح 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'] }
  })
});

الويب هوكس

تدفع Webhooks الصادرة أحداث دورة حياة الرسائل إلى نقطة النهاية HTTPS الخاصة بك في الوقت القريب من الفعلي. إدارة نقاط النهاية من المطورون → Webhooks — إضافة، تحرير، إيقاف مؤقت، اختبار وحذف.

الأحداث

• يجب أن تكون نقاط النهاية 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."
}