المراسلة (WhatsApp، Messenger، Telegram، Mattermost)

يدمج betool منصّات المراسلة الأكثر طلبًا. وتتّبع كلٌّ منها النموذج نفسه: وحدة *_inbound للاستقبال ووحدة *_outbound للإرسال.

WhatsApp Business

المتطلبات المسبقة

• حساب Meta Business.
• رقم WhatsApp Business معتمَد.
• تطبيق Cloud API مُهيَّأ بـwebhook.

الإعداد

1. الإعدادات ← الخدمات ← واتس آب، تبويب الحسابات — اربط تطبيق Meta الخاص بك بـApp Secret وPhone Number ID.
2. على جانب Meta، أضِف عنوان الـwebhook الذي يوفّره betool (https://platform.betool.ai/entries/whatsapp/<id>) وانسخ الـVerify Token المُولَّد.
3. اربط الرقم بـpipeline.

الخصوصيات

• القوالب المعتمَدة إلزامية لبدء محادثة (خارج نافذة الـ24 ساعة). وأنت تدير القوالب على جانب Meta؛ ويشير إليها betool بالاسم.
• الوسائط المدعومة: الصور، الصوت، الفيديو، المستندات. ويمكن بعد ذلك معالجة مستندات PDF وExcel بواسطة عقدة file_transform.

WhatsApp عبر Green API (Beta)

لرقم WhatsApp دون حساب Meta Business، يتّصل betool أيضًا بـGreen API (نسختك الخاصة، BYO): يُشغِّل المستقبِل greenapi_inbound pipeline عند كل رسالة واردة (تُنسَخ الوسائط إلى betool)، وترسل العقدة greenapi_outbound نصًّا أو ملفًا مع تعليق. ويتولّى betool بنفسه تثبيت الـwebhook لدى Green API.

• هذه ليست واجهة WhatsApp البرمجية الرسمية: فـGreen API يحاكي WhatsApp Web. ويمكن لـWhatsApp حظر الرقم، دون أي سبيل للطعن. للاستخدام مع العملاء بأحجام كبيرة، فضِّل الـCloud API أعلاه.
• لا قوالب ولا نافذة 24 ساعة؛ والمجموعات متاحة.
• الإرسال الناجح يثبت أنّ الرسالة في قائمة الانتظار، لا أنّها سُلِّمت.
• لا يمرّ الإرسال إلا عبر العقدة (exactly-once): لا توجد أي أداة (tool) تتيح لوكيل أن يرسل بمفرده.

Messenger

يُشغِّل المستقبِل messenger_inbound pipeline عند كل رسالة واردة إلى صفحتك على Facebook؛ وتردّ العقدة messenger_outbound. ولا تكون الردود الحرّة ممكنة إلا خلال 24 ساعة التالية لآخر رسالة من المستخدم (قاعدة Meta). التفاصيل والربط: Meta.

Telegram

المتطلبات المسبقة

bot مُنشأ عبر @BotFather (رمز API المميّز).

الإعداد

1. الإعدادات ← الخدمات ← تيليجرام، تبويب الحسابات — الصِق الرمز المميّز؛ ويهيّئ betool الـwebhook تلقائيًا.
2. اربط الـbot بـpipeline.

الخصوصيات

• يمكن إضافة الـbot إلى المجموعات أو استخدامه في المحادثات الخاصة.
• لا توجد حصص تقييدية كما في WhatsApp — مثالي للمساعدين الداخليين أو الإشعارات التشغيلية.

Mattermost

المتطلبات المسبقة

• نسخة Mattermost (سحابية أو مُستضافة ذاتيًا).
• webhook صادر على جانب Mattermost.

الإعداد

1. الإعدادات ← الخدمات ← ماتيرموست، تبويب الحسابات — أنشئ الاتصال وانسخ عنوان URL الذي يوفّره betool.
2. على جانب Mattermost، أنشئ webhook صادرًا يشير إلى ذلك العنوان.
3. اختياري: أنشئ incoming webhook في Mattermost للسماح لـbetool بنشر الردود.

الخصوصيات

• السلاسل محفوظة — تبقى ردود الوكيل في سلسلة السؤال الأصلي.
• القنوات الخاصة / الرسائل المباشرة — اختر النطاق أثناء التهيئة.

الاختيار