Skip to main content
يشرح هذا المسار كاملًا: العثور على قناة، واختيار قالب، وإرساله، وتأكيد وصوله. وكل استدعاء يستخدم الترويستين من المصادقة.
1

اعثر على القناة التي سترسل منها

channelId يحدد الحساب المربوط الذي تخرج منه الرسالة. احصل عليه مرة وخزّنه — فهو لا يتغير.
استخدم قناة حالتها connection_status هي connected. فأي حالة أخرى لا تستطيع الإرسال.
2

اختر قالبًا معتمدًا

أمران تقرأهما من هذا:
  • يجب أن تكون status هي APPROVED. فالقالب PENDING يُرفض عند الإرسال.
  • عُدّ العناصر النائبة في نص BODY. فوجود {{1}} و{{2}} يعني أن عليك تمرير templateParams اثنين بالضبط وبهذا الترتيب. وأي عدم تطابق يُفشل الإرسال.
3

أرسله

ستحصل على 202 Accepted والرسالة المنشأة:
يجب أن يكون to بصيغة E.164 بدون +201001234567. أما الرقم بالصيغة المحلية مثل 01001234567 فلا يُرفض؛ بل ببساطة لا يُسلَّم. طبّع الأرقام قبل الإرسال.
ولم تكن بحاجة إلى وجود محادثة مسبقًا: فـchannelId مع to يجد المحادثة أو يبدأ واحدة. وإن كان لديك conversationId بالفعل، فأرسله بدلًا منهما واحذفهما.
4

تأكد من وصولها

202 تعني في الطابور لا مُسلَّمة. اقرأ الرسالة مجددًا لترى إلى أين وصلت:
استطلع لفترة قصيرة، أو اعتبر sent نجاحًا وعالج failed منفصلة. ولا تنتظر read — فكثير من العملاء يعطّلون إيصالات القراءة ولن تصل أبدًا.

إرسال نص عادي

داخل نافذة الـ 24 ساعة — أي أن العميل راسلك مؤخرًا — يمكنك الرد بنص حر:
وخارج تلك النافذة يرفض واتساب ذلك. فإذا كان تكاملك يبدأ التواصل، أرسل قالبًا.

التالي

Zoho Desk: مراسلة العملاء عند إغلاق التذكرة

تكامل كامل مشروح، بما في ذلك صيغة الحمولة المسطّحة للمستدعين الذين لا يستطيعون إرسال JSON متداخل.