ملاحظة: لا توجد واجهة عربية لهذه الميزة بعد، فواجهة المنصّة كلها تظهر بالإنجليزية. لذلك تُنقَل النصوص المقتبَسة من الواجهة أدناه بالإنجليزية كما تظهر فعليًا، بدل أن تُترجَم أو تُختلَق بالعربية.
ربط البوت لا يتطلّب إلا رمزه ولا شيء غيره. تحتاج أولًا إلى بوت معدّ مسبقًا — يغطّي ما يتطلّبه Telegram موضوع BotFather — وبعدها لا يتعدّى الأمر استمارة واحدة.
اربطه
-
افتح /channels واضغط Add Channel.
-
اختر Telegram. الصفحة التي تفتح هي Connect Telegram، وعليها خطوات BotFather الثلاث تحت How to get your credentials:
Open Telegram and search for @BotFather Send /newbot and follow the prompts Copy the bot token BotFather gives you
-
تحت Credentials، املأ حقلَين:
- Channel Name — معبّأ مسبقًا بـ “Telegram”. اتركه، فيُسمّى القناة باسم البوت عند اتصاله: Telegram — @BrightwaterBikesBot. أو اكتب اسمًا من عندك.
- Bot Token (from @BotFather) — الصق الرمز.
-
اضغط Connect & Validate.
Channel connected successfully! You can now deploy an agent to this channel.
من تلك اللحظة، تصل إلى Omni Octo الرسائل التي يرسلها العملاء إلى البوت. الخطوة التالية هي اختيار مَن يردّ عليها — ضع وكيل ذكاء اصطناعي على بوتك. وحتى تفعل ذلك، تظلّ الرسائل تصل وتنتظر فريقك في /conversations.
ماذا يفعل Connect & Validate
أمرين، بالترتيب:
- يتحقّق من الرمز لدى Telegram. الرمز الذي يعمل يُخبر Omni Octo باسم المستخدم (@username) واسم البوت.
- يطلب من Telegram إرسال رسائل البوت إلى Omni Octo، بسرّ لا يعرفه إلا Telegram وOmni Octo. كل رسالة يسلّمها Telegram تحمله معها، وكل ما يصل دونه يُرفَض، فلا يستطيع أحد غيرك إرسال رسائل وهمية منسوبة إلى عملاء إلى صندوق واردك.
إن فشل أيٌّ من الخطوتين، قالت الصفحة Validation failed مع السبب. تُنشَأ القناة رغم ذلك، موسومة بـ Error، ويمكنك إصلاحها من صفحتها.
| ما يقوله السبب | معناه |
|---|---|
| Health check failed: 401: Unauthorized | الرمز خطأ، أو سُحب من BotFather. انسخه من جديد — كاملًا، بما في ذلك الجزء قبل النقطتين. |
| … is already connected to another Omni Octo channel | هذا البوت مرتبط في مكان آخر. يرسل Telegram رسائل البوت إلى مكان واحد فقط، فاحذف القناة الأخرى أولًا، أو اصنع بوتًا ثانيًا. |
| The bot token works, but Telegram could not be told to send this bot’s messages here | الرمز سليم؛ لم يقبل Telegram الخطوة الثانية. انتظر دقيقة واضغط Validate في صفحة القناة. |
صفحة القناة
افتح القناة من /channels. بجانب اسمها Telegram وحالتها — Active
حين تكون متصلة. تحت Platform Info تجد botUsername وbotName الخاصّين
بالبوت، كما أبلغ عنهما Telegram، وتحت Agents الوكيل الذي يردّ هنا، متى
وُجد واحد.
يظهر Validate حين لا تكون القناة Active. يعيد تشغيل الخطوتين معًا: استخدمه بعد إصلاح ما قال السبب.
تغيير الرمز
إن سحبت الرمز من BotFather، أو انتقلت إلى بوت جديد:
- في صفحة القناة، اضغط Update Credentials.
- الصق الرمز الجديد، ثم اضغط Save & Validate.
تعمل الخطوتان من جديد بالرمز الجديد، ويُعطى Telegram سرًّا جديدًا. رمز جديد للبوت نفسه يحفظ المحادثات التي لديك أصلًا. أمّا رمز بوت آخر فهو بوت آخر لدى عملائك: عليهم أن يجدوا البوت الجديد ويراسلوه.
حذف القناة
يزيل Delete في صفحة القناة القناةَ ويخلع عنها كل وكيل (الوكلاء أنفسهم يبقون):
… and all its deployments will be permanently removed. This cannot be undone.
يبقى البوت نفسه موجودًا في Telegram، ويظل العملاء قادرين على مراسلته، لكن لا يردّ أحد. لربطه من جديد، أضفه كقناة جديدة.
ربطه بمطالبة Octo
يستطيع Octo فعل الشيء نفسه من داخل محادثة. قل له ما تريد، مع الرمز:
Connect my Telegram bot and have the Brightwater receptionist answer it. The token is …يربط Octo البوت، ويطلب من Telegram أين تُرسَل رسائله، ويضع الوكيل عليه، سائلًا إذنك قبل الخطوات التي تغيّر ما يراه العملاء.
إلى أين بعد ذلك
- ضع وكيل ذكاء اصطناعي على بوتك — اختر وكيل الذكاء الاصطناعي الذي يردّ.
- بوت Telegram لا يردّ — ماذا تتفقّد حين لا تصل الرسائل أو لا يردّ أحد.