الـ Webhook الصادر
إعداد متقدم بيبعت كل رد من الوكيل الذكي أو فريقك لرابط بتاعك، عشان بوابة رسايل خاصة بيك توصّله للعميل.
ده إعداد متقدم ومعظم الوكالات مش محتاجاه. مع كل رد من الوكيل الذكي أو من فريقك، فلايباي بيبعت طلب POST فيه الرد لرابط إنت بتحدده، وبوابتك هي اللي توصّل الرسالة للعميل.
محتاجه ولا لأ؟
| وضعك | تعمل إيه |
|---|---|
| ربطت واتساب أو ماسنجر أو إنستجرام من فلايباي | سيبه مقفول. الردود بتوصل لوحدها |
| بتستخدم الشات العام بس | سيبه مقفول |
| عندك بوابة رسايل خاصة (زي n8n، أو مزوّد واتساب غير Meta) وعايز الردود توصلها | ده اللي محتاجه |
الإرسال بس، مش الاستقبال
الـ Webhook ده بيبعت الردود لبره بس. إدخال رسايل العملاء من بوابتك لفلايباي مش متاح كخدمة ذاتية حالياً. قبل ما تبني عليه، كلّمنا على support@flyby.world.
شغّله
افتح القنوات
«الإعدادات ← القنوات والربط»، وانزل لجزء «متقدم».
اكتب «رابط الإرسال» ودوس «حفظ»
الرابط لازم يبدأ بـ https:// ويكون عنوان عام على الإنترنت، زي https://gateway.example.com/flyby. بعد الحفظ البادج بيبقى مربوط.
البيانات اللي بنبعتها
مع كل رد، فلايباي بيبعت POST بـ Content-Type: application/json:
{
"agency_id": "…",
"conversation_id": "6f1c…",
"channel": "whatsapp",
"contact_phone": "+201001234567",
"sender": "ai",
"text": "أهلاً يا أحمد! …"
}| الحقل | معناه |
|---|---|
agency_id | رقم تعريف وكالتك في فلايباي |
conversation_id | رقم المحادثة، استخدمه عشان تربط الردود ببعض |
channel | القناة اللي المحادثة جاية منها، زي whatsapp أو web |
contact_phone | رقم العميل لو معروف (ممكن يبقى null) |
contact_instagram | بيتبعت مع ردود الفريق بس: حساب إنستجرام العميل لو معروف |
sender | ai لو الرد من الوكيل الذكي، و agent لو من حد في فريقك |
text | نص الرد نفسه |
إمتى بيتبعت؟
- ردود الوكيل الذكي: في أي محادثة مش على قناة Meta مربوطة في فلايباي، ومنها محادثات الشات العام.
- ردود فريقك: في المحادثات اللي مش من الشات العام، لما الرد ما يتبعتش من خلال قناة Meta مربوطة.
يعني لو واتساب مربوط من فلايباي، ردوده بتروح لـ Meta مباشرة ومش بتعدي على الـ Webhook.
نصايح لبوابتك
- رد بسرعة: فلايباي بيستنى لحد 8 ثواني بس.
- الإرسال مرة واحدة من غير إعادة محاولة. لو بوابتك كانت واقفة، الرد ده مش هيوصلها.
- الطلب مش موقّع، فخلي الرابط صعب التخمين (مثلاً فيه كود سري طويل في آخره).
اقفله
اقفل مفتاح «إرسال الردود لبوابتك». الرابط بيتمسح والإرسال بيقف على طول، وهيظهرلك «تم إيقاف الـ Webhook الخارجي».