خطاف الويب (webhook) للحقل history
يحمل history نقل المحادثات الحالية لرقم Coexistence إلى واجهة برمجة التطبيقات (API) لمرة واحدة. يصل بعد إكمال الإعداد عند قبول مشاركة السجل، وهو الإشارة الوحيدة التي تحصل عليها أي عملية تكامل لمعرفة أن النقل حدث أصلًا.
الفترة التي تلي إكمال الإعداد ويجب أن تبدأ المزامنة خلالها.
الخطأ الذي يظهر عند استخدام المزامنة من قبل.
الخطأ الذي يظهر عند محاولة تشغيلها خارج تلك الفترة.
ما الذي يسلّمه
يسلّم سجل الرسائل واحداً لواحد الذي كان موجوداً مسبقاً في تطبيق WhatsApp Business، كي لا يبدأ البرنامج دون سياق على رقم استخدمه النشاط التجاري لسنوات.
لا تشمل العملية المحادثات الجماعية، فهي مستبعدة بالكامل من API على رقم Coexistence، كما لا تشمل أدوات التطبيق نفسه. فالملصقات والردود السريعة ورسائل الترحيب والغياب لا مقابل لها في API، وتبقى على الجهاز.
يوجد هذا الحقل على أرقام Coexistence فقط. أما الرقم الذي أُضيف بالطريقة العادية، فلا يملك سجلاً سابقاً في التطبيق لنقله، ولذلك لا يوجد ما يسلّمه.
لماذا يعمل مرة واحدة
لأن النقل جزء من إكمال الإعداد، وليس قدرة مستمرة.
يُسأل مالك النشاط التجاري أثناء Embedded Signup عما إذا كان يريد مشاركة المحادثات الحالية. تؤدي الإجابة بنعم إلى السماح بتشغيل المزامنة، ولا يوجد إعداد يعيد تفعيلها لاحقاً، ولا endpoint يكررها. تعيد المحاولة الثانية الخطأ 2593107، وليس حدّاً للمعدل يزول لاحقاً.
هناك أيضاً مهلة. يجب بدء المزامنة خلال 24 ساعة من إكمال الإعداد، وتؤدي محاولة تشغيلها لاحقاً إلى الخطأ 2593108. ويعني تفويت أي من الشرطين فصل الرقم وإعادة العملية كاملة.
ما الذي ينبغي على المعالج فعله به
تعامل معه كدفعة تصل مرة واحدة وقد تكون كبيرة، لا كحركة إضافية على مسار الرسائل.
- أكّد الاستلام سريعاً وعالج البيانات بشكل غير متزامن، كما تفعل مع أي عملية تسليم أخرى.
- أزل التكرار باستخدام معرّف الرسالة، فقد تتداخل رسائل history والرسائل المباشرة قرب لحظة إكمال الإعداد.
- توقّع غيابه. فالرقم الذي رفض مالكه مشاركة السجل لا يرسل شيئاً هنا، ويجب أن يعمل التكامل في كلتا الحالتين.
- لا تجعل إكمال الإعداد متوقفاً عليه. إذ يمكن استخدام الاتصال قبل اكتمال النقل.
الأخطاء الشائعة
- بناء تكامل يتطلب وجود السجل. فالكثير من الأرقام تتصل من دونه.
- إعادة محاولة المزامنة بعد 2593107. فهذا حدث لمرة واحدة، ولذلك ستعيد المحاولة الخطأ نفسه.
- تأجيل قرار مشاركة السجل إلى بدء العمل على التكامل، وهو ما يحدث عادةً بعد انتهاء مهلة 24 ساعة.
يسجل EasyCoexistence عملية الإعداد واختيار السجل في المخطط الزمني للاتصال، لذلك يصبح اتصال الرقم وتاريخ مزامنته حقيقة مؤرخة، لا شيئاً ينبغي إعادة بنائه لاحقاً.
الأسئلة الشائعة
ما مقدار السجل الذي يصل؟
نافذة من المحادثات الحديثة واحداً لواحد، تحددها Meta وليس مزود الخدمة.
هل تنتقل المحادثات الجماعية؟
لا. فالمجموعات مستبعدة بالكامل من API على رقم Coexistence.
هل يمكنني طلبه مرة أخرى لاحقاً؟
لا. يعمل مرة واحدة لكل عملية إعداد، وتشغيله مجدداً يتطلب فصل الرقم وإعادة توصيله.
ماذا يحدث إذا رفض المالك مشاركة السجل؟
لا يصل شيء في هذا الحقل، ولا ترى API سوى الرسائل التي تبدأ من لحظة اتصال الرقم.
تابع القراءة
هل أنت مستعد للبدء؟
أعد إعداد WhatsApp Coexistence خلال دقائق، وليس أشهر. يواصل التطبيق العمل على الهاتف.
ابدأ الفترة التجريبية المجانيةتم التحقق في