ربط واتساب وإنستغرام وماسنجر

كيف تجعل بوتك يردّ على رقم واتساب أو صفحة فيسبوك أو حساب إنستغرام الذي يراسلك عليه عملاؤك اليوم — ببيانات اعتماد Meta الخاصة بك، لأن طريق النقرة الواحدة ما زال بانتظار موافقة المنصّة.

---

ما الذي يفعله ربط قناة من قنوات Meta؟

هنا يتوقّف البوت عن كونه شيئًا تجرّبه في المحاكي، ويبدأ بالردّ على عملاء حقيقيين في التطبيق المفتوح أمامهم أصلًا.

خذ «دار العود»، متجر عود وعطور في الرياض. فيصل صاحبه، يبيع على Salla، وكتالوجه مُزامَن مع Botragon منذ مدة. وطوال اليوم تصل إلى رقم واتساب للأعمال لديه ثلاثة أسئلة لا تتغيّر: هل العود الكمبودي متوفّر، وبكم دهن العود، وهل التوصيل إلى الدمام متاح. بنى فيصل بوتًا يجيب عن الثلاثة جميعًا. وهذا البوت لا يجيب أحدًا الآن، لأنه غير مرتبط برقمه. ربط القناة هو السلك بين الاثنين.

وللربط طريقان، وهما غير متكافئين اليوم.

• بيانات اعتمادك أنت من Meta. تنشئ تطبيق Meta، وتولّد رمز وصول، وتلصقه في Botragon. هذا الطريق يعمل اليوم، وهذه الصفحة تمشي فيه من أوله إلى آخره.
• الربط عبر Meta بنقرة واحدة. يعرض Botragon زر «اربط واتساب عبر Meta» على كل قناة. لم توافق Meta على Botragon بعد، ولذلك لا يعمل هذا الزر للتجّار. وقائمة تجهيز مساحة عملك تقول ذلك بكلمات المنتج نفسه: «واتساب وإنستغرام وماسنجر — بانتظار موافقة المنصّة»، ونصّها: «يجب أن توافق Meta على Botragon قبل أن يتمكن عملاؤك من مراسلتك عبر هذه القنوات. لا يوجد إجراء مطلوب منك هنا بعد — وتتحول هذه الخطوة إلى زر ربط في اليوم الذي تصل فيه الموافقة.»

لا نملك تاريخًا لهذه الموافقة، ولا أحد في Botragon يملكه. وإن ذكر لك أحد تاريخًا، فهو لم يأتِ من المنتج.

وأي تطبيق Meta يعمل خلفه الرمز الذي تلصقه. لا يقول المنتج هذا في أي موضع، وأنت تحتاجه لتقرأ الأخطاء بعد قليل. القناة التي تربطها بلصق رمز تُسجَّل عاملة على تطبيق Meta المشترك من Botragon — في الحالتين معًا. وتفعيل تطبيق Meta الخاص بك لمساحة العمل كلها (انظر «خياراتك» أدناه) لا يغيّر ذلك: فهذا الإعداد لا يبلغ إلا القنوات المربوطة عبر مسار النقرة الواحدة، وهو مغلق اليوم، وصفّ الخيار نفسه ينبّهك أن القنوات المربوطة بلصق رمز لا تنتقل معه. فالحالة واحدة عمليًا لا اثنتان: رمزك أنت، وتطبيق Botragon.

وهذا الانفصال لا يضرّ ما يهمّك أكثر. فإرسال الرسالة يحمل رمز وصولك وحده — لا سرّ تطبيق ولا توقيع — ورقم واتساب الذي ربطته يجيب عملاءك كالمعتاد. والموضع الذي يعضّ فيه هذا الانفصال هو فحص السلامة الدوري. ففي واتساب وإنستغرام — لا في ماسنجر — يوقّع هذا الفحص نداءه إلى Meta بسرّ التطبيق الذي يعدّه Botragon مالك القناة، وهو في القناة المربوطة بلصق رمز تطبيق Botragon دائمًا، بينما وُلد الرمز الذي لصقته في تطبيقك أنت. وترفض Meta التوقيع الذي لا يطابق التطبيق الذي أصدر الرمز، بخطأ من عائلة 190، ويقرأ Botragon هذا الرفض على أنه رمز سُحبت صلاحيته. ولن ترى عندها عبارة «appsecret proof» أصلًا. الذي تراه أن شارة سلامة القناة تتحوّل إلى «يلزم إعادة الربط»، ومن تلك اللحظة يمتنع Botragon عن الإرسال على هذه القناة، ويختفي إجراء «تعديل رمز الوصول» من صفّها، لأن الإصلاح الوحيد الذي يعرضه المنتج لهذه الحالة هو «إعادة الربط عبر Meta»، وهو من مسار النقرة الواحدة المغلق. والمخرج أن تحذف صفّ القناة وتربطها من جديد: يعود الصفّ إلى «سليم» ويعود الإرسال، إلى أن يمرّ الفحص التالي. وحدٌّ واحد نقوله بصراحة: نقرأ هذا من الكود لا من حسابك أنت. لا نرى صفّك، والفحص لا يبلغ كل قناة — فصفّ واتساب الذي لم يستخرج له Botragon معرّف حساب واتساب للأعمال يُتخطّى، وماسنجر لا يُوقَّع بهذه الطريقة أصلًا. فهذا ما سيحدث، لا دعوى عمّا حدث لك أنت حتى الآن. أما «مشكلة في إعداد الخادم» — «حدث خطأ لدينا (appsecret proof).» — فشيء آخر تمامًا، و«حين لا يعمل ← 1» أدناه يقول ما هو.

وأمر واحد لا يفعله ربط القناة: لا يبدأ رسائل السلال المتروكة واستعادتها. تبقى الاستعادة في «الوضع التجريبي — لا تُرسل أي رسائل فعلية»؛ التذكيرات تُخطَّط وتُحتسب ولا تُرسَل، و«يبدأ الإرسال بعد اعتماد المراسلة عبر واتساب» كما تقول قائمة التجهيز نفسها.

---

ما الذي تحتاجه قبل أن تربط واتساب؟

• أن تكون مديرًا في مساحة العمل. المشرفون وموظفو الدعم والمشاهدون لا يرون أزرار الربط أصلًا، ولا يستطيعون فتح صفحة «مزوّد Meta». فإن غاب عنك زر تذكره الخطوات أدناه، فهذا سببه.
• أن يكون لديك بوت. القنوات ترتبط ببوت، لا بمساحة العمل. أنشئ البوت من «البوتات» أولًا، ثم عد إلى هنا.
• باقتك لا تحدّ من هذا. لا يوجد حدّ للقنوات في أي باقة من باقات Botragon. وإن ظهرت لك يومًا رسالة «بلغت حدّ القنوات»، فهي خطأ — أبلغ الدعم بها.
• أن يكون لديك حساب Meta Business، وبحسب القناة: - واتساب — رقم واتساب للأعمال، وحساب تجاري موثَّق إن أردت مراسلة أحد خارج أرقام الاختبار لدى Meta. - ماسنجر — صفحة فيسبوك أنت مديرها. - إنستغرام — حساب إنستغرام للأعمال أو للمبدعين مرتبط بصفحة فيسبوك أنت مديرها. الحساب الشخصي لا ينفع.
• وقيمة واحدة لا يعطيها إلا Botragon: رمز التحقق. اطلبه من دعم Botragon قبل أن تبدأ. لا يظهر في أي مكان داخل المنتج، ولا يمكنك إنهاء الإعداد لدى Meta بدونه. تفصيله في الخطوات.

---

ما خياراتك في ربط واتساب؟

إعداد «مزوّد Meta» شغل منفصل عن ربط قناة، وليس مطلوبًا لأي شيء في هذه الصفحة. لا تبدأ منه.

---

كيف تربط واتساب ببوتك؟

عند Meta — ابدأ بهذا الجزء. هذه الشاشات ملك Meta، فلا لقطات لها من Botragon.

1. ادخل إلى developers.facebook.com، وافتح My Apps، واختر Create App. اختر نوع Business — وهو النوع الوحيد الذي يقدّم واتساب وماسنجر وإنستغرام.
2. أضف في تطبيقك الجديد منتج القناة التي تريدها: WhatsApp أو Messenger أو Instagram. أضف ما ستستخدمه فعلًا لا غير.
3. اربط التطبيق بحساب Meta Business لديك من Settings → Basic → Business Account. ولواتساب، يجب توثيق حسابك التجاري قبل أن تراسل عملاء خارج أرقام الاختبار لدى Meta.
4. انسخ معرّف الحساب الخاص بقناتك واحفظه في مكان تلصق منه: - واتساب — قيمة phone number ID في «واتساب ← إعداد API». - ماسنجر — المعرّف الرقمي للصفحة، في ترويسة إعدادات الصفحة. - إنستغرام — المعرّف الرقمي للحساب، في Business Manager تحت Instagram Accounts.
5. ولّد رمز الوصول وانسخه: - واتساب — تعطيك «واتساب ← إعداد API» رمزًا مؤقتًا يموت بعد 24 ساعة. وللحصول على رمز يدوم، أنشئ System User في Business Settings، وأسنِد إليه تطبيق واتساب وحسابك التجاري في واتساب، ثم ولّد رمزًا دائمًا. - ماسنجر وإنستغرام — ولّد Page Access Token لصفحتك يحمل pages_messaging وpages_show_list وpages_manage_metadata. ويستعير إنستغرام أذوناته من الصفحة المرتبطة به.
6. راسل دعم Botragon واطلب منه رمز التحقق الخاص بالويب هوك لديك. لا تتخطَّ هذه الخطوة ولا تخمّن القيمة. ستحتاجها في الخطوة 18، ولا سبيل إلى معرفتها بنفسك.

في Botragon.

التسميات في الخطوات أدناه كما تقرأها على شاشتك. تبويب «القنوات»، ونافذة الربط، وأزرار صفوف القنوات، وشارات الحالة — كلها بالعربية على واجهة عربية. ويبقى بحروفه اللاتينية ما هو لـ Meta نفسها: أسماء منتجاتها مثل Meta Business Manager، وأسماء الحقول والصلاحيات مثل messages وpages_messaging.

7. افتح «البوتات» من الشريط الجانبي.
8. افتح البوت الذي تريد وضعه على هذه القناة.
9. افتح تبويب «القنوات».
10. تحت ترويسة «القنوات المتصلة»، اضغط «لصق رمز الوصول» — الزر الباهت الصغير المجاور لأزرار «اربط … عبر Meta» الكبيرة. تجاهل الأزرار الكبيرة؛ فهي الطريق الذي لم تفتحه Meta بعد.
11. في نافذة «اربط قناة»، اختر قناتك من قائمة «القناة».
12. الصق معرّف الحساب من الخطوة 4 في حقل «معرّف حساب القناة».
13. الصق رمزك من الخطوة 5 في حقل «رمز الوصول».
14. لواتساب برمز مؤقت وحده: الصق معرّف حسابك التجاري في واتساب في حقل «معرّف حساب واتساب للأعمال». تخطَّ هذه الخطوة إن كان رمزك رمز System User دائمًا.
15. اضغط «ربط». ويقرأ الزر «جارٍ الربط…» ريثما يُحفَظ.
16. في اللوحة التي تظهر، اضغط «نسخ» بجوار «رابط استقبال الرسائل» (رابط الويب هوك). ولا تضغط «إظهار» إن كان أحد يرى شاشتك — فذلك الرابط كلمة مرور متنكّرة.

عودة إلى Meta — النصف الذي يجعل الرسائل تصل فعلًا.

17. افتح في تطبيقك لدى Meta قسم Webhooks أو «الإعداد» الخاص بالقناة، والصق الرابط في حقل «رابط رد الاتصال».
18. الصق رمز التحقق الذي أعطاك إياه الدعم في الخطوة 6 في حقل رمز التحقق في صفحة Meta نفسها.

تقول اللوحة على شاشتك إن هذا الحقل «يقبل أي قيمة». هذه الجملة خاطئة. إن كتبت أي شيء غير الرمز الذي أعطاك إياه الدعم، رفضت Meta حفظ الويب هوك، وأظهرت لك الخطأ عندها هي لا في Botragon. نحن نصلح الجملة؛ أما أنت فاستخدم الرمز.

19. اشترك في الحقول التي تطلب Meta اختيارها: messages وmessaging_postbacks وmessage_deliveries لواتساب وماسنجر، وmessages وmessaging_postbacks لإنستغرام.
20. عد إلى Botragon واضغط «تم».

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

---

كيف تعرف أن القناة قد ارتبطت؟

تستبدل نافذة «اربط قناة» نفسها بلوحة عنوانها «✅ تم ربط القناة». تحمل هذه اللوحة رابط الويب هوك مخفيًا خلف «إظهار» و«إخفاء» و«نسخ»، وتقول لك إن الرابط يُخزَّن مشفّرًا، وإنك تستطيع عرضه مجددًا في أي وقت من صف هذه القناة عبر زر «عرض رابط استقبال الرسائل» — وللمديرين وحدهم. لا إشعار منبثق ولا بريد. هذه اللوحة هي الإشارة كلها، ولا تصلك بهذه الصورة إلا مرة واحدة.

أغلق اللوحة، وللقناة الآن صف خاص بها تحت «القنوات المتصلة»، يعرض معرّف الحساب، وشارة تقرأ «يدوي»، وشارة صحّة تقرأ «سليم». وفي «نظرة عامة»، تُعلَّم خطوة القناة في قائمة «جهّز مساحة عملك».

والآن الجزء المهم، واقرأه مرتين. يقرأ ذلك الصف «سليم» في اللحظة التي يُنشأ فيها، قبل أن تمرّ رسالة واحدة عبر Meta. هو يخبرك أن بيانات اعتمادك حُفِظت، لا أن بوتك يجيب. وهاتان حقيقتان مختلفتان:

• «مرتبط» تعني أن Botragon خزّن ما لصقته.
• «يعمل» تعني أن Meta قبلت الويب هوك في الخطوة 18، وأن رسالة حقيقية وصلت إلى بوتك.

فلا تقف هنا. راسل رقمك من هاتف آخر. فإن ردّ البوت فقد انتهيت. وإن لم يحدث شيء، فانتقل إلى القسم التالي — وعد إلى صف القناة بعد ساعات، لأن ويب هوك معطوبًا يقلب شارة الصحة في النهاية إلى «أخطاء في استقبال الرسائل» مع الملاحظة «مشكلة في استقبال الرسائل — ما زال البوت يرسل. تأكّد أن Meta ما زالت ترسل رسائل هذا الرقم إلى Botragon.»

---

لماذا لا يتم ربط قناة واتساب؟

1. بياناتك حُفِظت، ولا يصل شيء

ما تراه: لا شيء إطلاقًا في Botragon. لوحة نجاح خضراء، وشارة «سليم»، وبوت لا يجيب أحدًا. أما الخطأ، إن وُجد، فجالس في لوحة تحكّمك لدى Meta.

لماذا يحدث: لا يتحقّق Botragon مما تلصقه أبدًا. لا يوجد زر لاختبار الاتصال في هذه الشاشة، لأي قناة. يفحص النموذج شكل ما كتبته ولا شيء غير ذلك — رمز فيه خطأ مطبعي، ورمز منتهية صلاحيته، ورمز سليم تمامًا، تُحفظ كلها بالطريقة نفسها. ويُكتشف كل شيء لاحقًا، عند Meta، حين تحاول رسالة حقيقية أن تتحرك.

ما تفعله: عامل الحفظ على أنه الخطوة الأولى من اثنتين. أرسل إلى نفسك رسالة تجريبية. فإن لم يعد شيء، فافحص بهذا الترتيب: رمز التحقق في الخطوة 18 — وهو السبب الأشيع وحده — ثم كون حقول الويب هوك في الخطوة 19 مشتَركًا فيها فعلًا، ثم كون رمز وصولك لم تنتهِ صلاحيته. وانتبه لرسالة واحدة مربكة، ولما ليست هي. إن رأيت يومًا «مشكلة في إعداد الخادم» — «حدث خطأ لدينا (appsecret proof). تواصل مع الدعم.» — فهذه الجملة صادقة: يرفعها Botragon داخل كوده هو، قبل أن يخرج النداء إلى Meta أصلًا، حين يكون سرّ تطبيق Meta الذي ذهب يقرأه ناقصًا أو غير مقروء عندنا نحن. ولا شيء مما تلصقه يُنتجها، ولا تُصلَح بإعادة اللصق. والفحص الذي يحسم الأمر هو موضع ظهورها: نافذة «اربط قناة» هذه لا تعرض تلك الرسالة إطلاقًا — لا يعرضها إلا نافذة «ربط … عبر Meta» وصفحة «الإعدادات ← مزوّد Meta». فإن رأيتها هناك فهي منّا: تواصل مع الدعم، واذكر له هذه الصفحة. ولا تخلطها بمشكلة التوقيع الأخرى المشروحة في «ما الذي تفعله» أعلاه — فالرمز المولود في تطبيق Meta الخاص بك حين يسقط في توقيع فحص السلامة لا يُظهر هذه الرسالة أبدًا، بل يحوّل شارة القناة إلى «يلزم إعادة الربط».

2. زر «اربط … عبر Meta» يرفض

ما تراه: تضغط «اربط واتساب عبر Meta»، فإما تُفتح نافذة تحمل تنبيهًا عنوانه «وضع التطوير» يبدأ بـ «تشترط Meta إضافة حسابك الشخصي على فيسبوك مختبِرًا في لوحة الأدوار في التطبيق.»، وإما تصلك رسالة «تسجيل الدخول عبر Meta غير مُعدّ» — «تنقص Botragon بيانات اعتماد تطبيق Meta. تواصل مع المسؤول — هذه مشكلة إعداد على الخادم.» وقد ترى بدلًا منها «مزوّد Meta غير مُعدّ» — «لا تملك مساحة عملك في Botragon إعداد مزوّد Meta نشطًا بعد. تواصل مع المسؤول.»

لماذا يحدث: هذا هو الطريق الذي لم تعتمده Meta. ما زال تطبيق Meta الخاص بـ Botragon في وضع التطوير، ولا تسمح Meta لأحد بتسجيل الدخول عبر تطبيق في وضع التطوير ما لم يكن مدرجًا فيه مختبِرًا. والتنبيه موجَّه إلى مطوّر لأنه لم يُكتب ليصل إليك أصلًا.

ما تفعله: اترك هذا الزر واستخدم «لصق رمز الوصول» بدلًا منه — أي قسم الخطوات أعلاه بكامله. لا شيء في حسابك يفتح هذا الطريق. وهو يُفتح للجميع دفعة واحدة، في اليوم الذي تعتمد فيه Meta تطبيق Botragon.

3. تفتح إعدادات «مزوّد Meta» ولا تستطيع استخدامها

ما تراه: تعرض «الإعدادات ← مزوّد Meta» بطاقة عنوانها «الإعداد الافتراضي من Botragon»، نصّها: «مساحة عملك تستخدم تطبيق Meta المشترك من Botragon. لا يمكنك إعداد تطبيق Meta مخصص لأن خيار «تطبيق Meta الخاص (BYO)» غير مفعّل لمساحة العمل هذه.» ويتبعها: «تواصل مع مسؤول Botragon لديك لتفعيل الخيار إذا أردت تشغيل بوتاتك عبر تطبيق Meta الخاص بك.» وإن وصلت إلى الإعداد من طريق آخر، ظهرت لك رسالة «تطبيق Meta الخاص غير مفعّل» — «مساحة عملك لا تملك تفعيل «تطبيق Meta الخاص». تواصل مع المسؤول لتفعيله.»

لماذا يحدث: تشغيل مساحة عملك كلها عبر تطبيق Meta الخاص بك يفعّله لك Botragon، مساحة عمل واحدة في كل مرة. وهو مطفأ افتراضيًا، ولا يوجد زر طلب في الصفحة.

ما تفعله: لا شيء، إن كنت تتبع هذه الصفحة — فأنت لست بحاجة إليه. ربط قناة بلصق رمز يعمل عبر التطبيق المشترك ولا يتأثر بهذا الخيار. تواصل مع دعم Botragon فقط إن كنت تريد تحديدًا تطبيق Meta خاصًا بك لمساحة العمل كلها، وكن مستعدًا لبيان السبب.

---

وخطأ أخير يستحق أن تعرفه قبل أن يربكك. إن نفد رمزك، قال Botragon «انتهت صلاحية رمز القناة» — «انتهت صلاحية رمز وصول هذه القناة. استخدم «إعادة الربط عبر Meta» لتحديثه — ويبقى بوتك مرتبطًا بالرقم نفسه.» وهذه النصيحة لا تنطبق عليك. «إعادة الربط عبر Meta» هي الطريق المسدود نفسه. أما على قناة ربطتها بلصق رمز، فاستخدم «تعديل رمز الوصول» في صف القناة، والصق رمزًا جديدًا من Meta — ما دامت شارة سلامة الصفّ لا تزال تقرأ «انتهت صلاحية رمز الوصول». فإذا كانت الشارة قد تحوّلت إلى «يلزم إعادة الربط»، فقد اختفى «تعديل رمز الوصول» من الصفّ، والإصلاح حينها هو المذكور أعلاه: احذف صفّ القناة واربطها من جديد.

---

→ العودة إلى دليل التاجر في Botragon