ما يمكنك فعله
إرسال رسالة
قوالب أو وسائط أو نص عادي — نقطة نهاية واحدة للثلاثة.
قراءة المحادثات
عرض المحادثات وتصفح سجل رسائلها.
عرض القوالب
معرفة قوالب واتساب المعتمدة التي يمكن للقناة إرسالها.
العثور على قنواتك
كل نقطة نهاية أخرى تحتاج
channelId — ومن هنا تحصل عليه.نقل عميل محتمل
قراءة مراحل مسارك، وتغيير مرحلة عميل محتمل، وإعادة إسناده.
تسجيل متابعة
تسجيل مكالمة أو بريد أو اجتماع على عميل محتمل.
جهات الاتصال في شركة
الأشخاص المرتبطون بسجل عميل.
استقبال الأحداث
نرسل POST إلى نقطة نهايتك عند وصول رسالة أو تحرك عميل محتمل. بلا استطلاع دوري.
نسخ العملاء المحتملين إلى أودو
كل عميل محتمل يُلتقط هنا يظهر في أودو لديك ويبقى متوافقًا.
قبل أول استدعاء
1
أنشئ مفتاح API
في لينكياسوفت، اذهب إلى الإعدادات ← مفاتيح API. ويُعرض المفتاح مرة واحدة عند الإنشاء —
انسخه حينها. وامنحه النطاقات التي يحتاجها التكامل فقط؛ راجع المصادقة.
2
اعثر على قناتك
استدعِ
GET /v1/connect/channels.
فـid القناة التي تريد الإرسال منها هو channelId الذي تطلبه كل نقطة نهاية أخرى.3
أرسل شيئًا
اتبع البداية السريعة لإرسال أول قالب لك.
قاعدة واتساب التي تُوقع الجميع
لا يسمح لك واتساب بإرسال نص حر إلا خلال 24 ساعة من آخر رسالة للعميل. وخارج تلك النافذة — وهو الحال دائمًا تقريبًا مع أي إشعار يبدأه نظامك — يجب إرسال قالب معتمد. ولانستجرام وماسنجر وتيليجرام قواعدها الخاصة؛ والمبدأ نفسه ينطبق.الاصطلاحات
- كل أجسام الطلبات والاستجابات بصيغة JSON.
- الطوابع الزمنية بصيغة ISO 8601 بتوقيت UTC.
- المعرّفات من نوع UUID ما لم يُذكر خلاف ذلك.
- أرقام الهواتف بصيغة E.164 بدون
+—201001234567، لا01001234567أبدًا. - عمليات الإرسال تعيد
202 Accepted: أي أن الرسالة في الطابور ولم تُسلَّم بعد. تابع النتيجة عبر حقلstatusفي الرسالة.