Viber #

قم بتوصيل بوت Viber الخاص بك حتى تتدفق محادثات Viber إلى التطبيق ويتمكن وكيل الذكاء الاصطناعي من الرد عليها. يمكنك الاتصال عن طريق لصق قيمة واحدة (رمز المصادقة الخاص بالبوت) وسنتولى نحن بقية الإعداد نيابةً عنك.

ما هو تكامل Viber؟ #

يربط تكامل Viber بوت Viber الذي تمتلكه بالمنصة باستخدام واجهة برمجة تطبيقات البوت الرسمية من Viber، وهو نظام Viber الخاص لإرسال واستقبال الرسائل تلقائيًا بدلاً من كتابتها يدويًا. تصبح المحادثات بين البوت الخاص بك والأشخاص الذين يتابعونه متاحة داخل التطبيق، ويعمل وكيل الذكاء الاصطناعي وصندوق الوارد المشترك فوق هذه المحادثات.

هذا تكامل رسمي، لذا فهو مستقر وضمن قواعد Viber.

التوفر. يُستخدم Viber على نطاق واسع في الفلبين وفيتنام وأجزاء أخرى من جنوب شرق آسيا، وفي جميع أنحاء أوروبا الشرقية واليونان.

قبل البدء #

أنت بحاجة إلى بوت Viber خاص بك، ولا تصدر Viber البوتات إلا ضمن خطة عمل مدفوعة. منذ فبراير 2024، لم تعد Viber تنشئ بوتات مجانية. أنت تقوم بإعداد الحساب مباشرة مع Viber، ويبقى هذا الحساب ورسومه بينك وبين Viber. نحن لا نعيد بيعه أو نزيد سعره أو نأخذ عمولة منه، ولا يمكننا إنشاء البوت نيابةً عنك.

في وقت كتابة هذا التقرير، تفرض Viber رسومًا شهرية لكل بوت بالإضافة إلى رسوم لكل رسالة يبدأها البوت الخاص بك (انظر التكلفة أدناه). تحقق من شروط Viber الحالية عند التسجيل، حيث إن تسعيرها يخضع لتغييراتهم الخاصة.

لا يوجد نموذج تسجيل ذاتي. تراجع Viber كل طلبات روبوتات الدردشة يدويًا، ويمكنك التقديم بإحدى طريقتين:

• من خلال شريك معتمد لـ Viber، وهو المسار الذي توصي به Viber وعادة ما يكون الأسرع.
• مباشرةً مع Viber، عن طريق إرسال بريد إلكتروني إلى partners@viber.com. إذا كنت تعمل بالفعل مع Viber، فيمكن لمدير حساب عملك بدء العملية بدلاً من ذلك.

بمجرد الموافقة على طلبك، تقوم بتوقيع اتفاقية Viber وقبول شروطهم التجارية، ومن ثم يتم إنشاء الروبوت الخاص بك.

بعد ذلك، ستجد الرمز الخاص به في تطبيق Viber ضمن المزيد ← الإعدادات ← البوتات ← تعديل المعلومات ← مفتاح تطبيقك (More → Settings → Bots → Edit Info → Your app key). يطلق عليه Viber اسم مفتاح التطبيق (app key)؛ بينما تسميه وثائق واجهة برمجة التطبيقات (API) الخاصة بهم رمز المصادقة (authentication token)، ويمكن لمسؤولي البوتات رؤيته أيضاً في لوحة تحكم المسؤول الخاصة بـ Viber. بغض النظر عن التسمية، فهو القيمة الوحيدة التي يطلبها هذا التطبيق.

هذا الرمز هو الشيء الوحيد الذي تحتاجه من Viber. يستغرق الإعداد هنا حوالي دقيقة.

إعداد Viber #

الخطوة 1: انسخ رمز مصادقة البوت الخاص بك #

أسرع مكان للعثور عليه هو تطبيق Viber على هاتفك.

1. افتح Viber على الهاتف الذي يمتلك حسابه الروبوت.
2. انتقل إلى المزيد (More) ← الإعدادات (Settings) ← الروبوتات (Bots).
3. حدد الروبوت الخاص بك واضغط على تعديل المعلومات (Edit Info).
4. انسخ القيمة المعروضة تحت مفتاح التطبيق الخاص بك (Your app key). هذا هو الرمز المميز.

حافظ على سرية هذا الرمز. يمكن لأي شخص يمتلكه إرسال رسائل باسم البوت الخاص بك.

الخطوة 2: توصيل Viber في التطبيق #

1. في الشريط الجانبي الأيسر، انقر على الإعدادات (Settings) بالقرب من الأسفل.
2. في القائمة الجانبية للإعدادات، تحت القنوات (Channels)، انقر على القنوات (Channels).
3. ابحث عن بطاقة Viber وانقر على اتصال (Connect).
4. الصق رمز المصادقة (auth token) الخاص بك.
5. انقر على اتصال (Connect).
6. يتحقق التطبيق من الرمز مع Viber ويعرض “متصل بـ: <اسم البوت الخاص بك>”.

لا يوجد خطاف ويب (webhook) لإعداده. على عكس معظم القنوات الأخرى، نقوم بتسجيل كل شيء لدى Viber نيابةً عنك كجزء من عملية الاتصال، لذا لا يوجد شيء لنسخه إلى وحدة تحكم أخرى. تعرض شاشة الاتصال العنوان الذي تصل إليه رسائلك فقط لكي تتمكن من مشاركته مع فريق الدعم إذا احتجت إلى ذلك في أي وقت.

الخطوة 3: اختبار الروبوت #

1. من هاتف مختلف، افتح Viber وتابع البوت الخاص بك (ابحث عنه، أو استخدم رابطه).
2. أرسل له رسالة.
3. افتح التطبيق وانتقل إلى المحادثات (Chats). ستظهر الرسالة الواردة في قائمة المحادثات.
4. إذا كان وكيل الذكاء الاصطناعي (AI Agent) يتعامل مع هذه القناة، فسترى ردًا تلقائيًا.

بمجرد الاتصال، سيظهر بوت Viber الخاص بك كـ متصل (Connected) في صفحة القنوات، وسيقوم الذكاء الاصطناعي بالرد على الرسائل الواردة.

من يمكن للبوت الخاص بك مراسلته #

هذا هو أهم شيء يجب فهمه حول Viber، وهو يختلف عن أي قناة أخرى:

لا يمكن للبوت الخاص بك مراسلة سوى الأشخاص الذين يتابعونه. يجب على شخص ما العثور على البوت الخاص بك ومتابعته قبل أن تتمكن من إرسال أي شيء إليه. لا توجد طريقة لمراسلة مستخدم Viber لم يقم بمتابعة البوت الخاص بك أولاً.

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

بسبب هذا، يعمل Viber بشكل جيد جدًا كـ قناة دعم ورد (يقوم شخص ما بمراسلتك، فيرد الذكاء الاصطناعي) وبشكل سيئ كقناة للتواصل البارد (cold-outreach).

التكلفة #

Viber قناة مجانية في التطبيق: لا توجد رسوم لكل رسالة ولا رسوم اتصال شهرية منا.

تأتي تكاليفك من Viber، على حسابك الخاص:

• رسوم شهرية لكل بوت (حوالي 100 يورو في وقت كتابة هذا التقرير).
• الردود داخل محادثة بدأها شخص ما مجانية وغير محدودة. يغطي هذا كل ما يقوم به وكيل الذكاء الاصطناعي تقريبًا.
• الرسائل التي يبدأها البوت الخاص بك، خارج محادثة بدأها الشخص، يتم محاسبتك عليها لكل رسالة بسعر يعتمد على بلد المستلم.

الخلاصة العملية: الرد على الأشخاص لا يكلفك شيئًا بخلاف الرسوم الشهرية. البث والمتابعات الاستباقية هي ما يضيف إلى التكاليف.

رسائل الوسائط #

يتم التعرف على الصور ومقاطع الفيديو والملفات والملصقات والمواقع وجهات الاتصال المشتركة الواردة حتى يعرف الذكاء الاصطناعي أنه تم إرسال وسائط (تتم إضافة ملاحظة قصيرة إلى المحادثة). ردود الذكاء الاصطناعي الصادرة في هذا الإصدار هي نصوص وصور. يتم تقصير الردود الطويلة تلقائيًا لتناسب حد Viber البالغ 7000 حرف.

إدارة الجلسة #

التحقق من حالة الاتصال #

يتم عرض حالة اتصال Viber الخاصة بك على بطاقة Viber في صفحة القنوات (Channels):

تقوم البطاقة بإعادة فحص البوت الخاص بك في كل مرة تفتح فيها صفحة القنوات. لا يمكن لبوت Viber إرسال رسائله إلا إلى مكان واحد في كل مرة، لذا إذا قمت بربط نفس البوت بأداة أخرى، فإن تلك الأداة ستتولى السيطرة وستتوقف رسائلك عن الوصول إلى هنا، دون أي تحذير من Viber. هذا هو ما تعنيه حالة “متصل، يلزم اتخاذ إجراء”. افتح البطاقة وأعد الاتصال لاستعادة السيطرة.

قطع الاتصال #

افتح بطاقة Viber وانقر على إدارة (Manage)، ثم انقر على قطع الاتصال (Disconnect) وأكّد خيار إزالة Viber؟ (Remove Viber?). هذا يمنعنا من تلقي رسائل البوت ويزيله من حسابك. يظل البوت ملكاً لك، ولا يتغير أي شيء في حساب Viber الخاص بك.

القيود #

• المتابعون فقط. لا يمكن للبوت الخاص بك مراسلة سوى الأشخاص الذين يتابعونه. راجع من يمكن للبوت الخاص بك مراسلتهم.
• تحتاج إلى بوت Viber مدفوع خاص بك. لا يمكننا توفير واحد.
• بوت واحد لكل اتصال. اربط كل بوت على حدة؛ لا يمكن ربط البوت إلا بحساب واحد فقط.
• إرسال النصوص + الصور. يرد الذكاء الاصطناعي بالنصوص والصور؛ لا يتم إرسال الكاروسيلات (carousels) والبطاقات الغنية (rich cards) في هذا الإصدار.
• لا توجد رسالة ترحيب. عندما يفتح شخص ما البوت الخاص بك لأول مرة ولكنه لم يتابعه بعد، يسمح Viber برسالة ترحيب فورية واحدة. هذا الإصدار لا يرسل واحدة. تبدأ المحادثة عندما يرسل المستخدم رسالته الأولى.

استكشاف الأخطاء وإصلاحها #

رفض الرمز المميز (Token) عند الاتصال #

• تأكد من أنك نسخت القيمة من تعديل المعلومات → مفتاح تطبيقك (Edit Info → Your app key) في تطبيق Viber، وليس معرفاً مختلفاً.
• تحقق من أن البوت الخاص بك لا يزال نشطاً في حساب Viber الخاص بك.
• يتحقق الاتصال أيضاً من أن Viber يمكنه الوصول إلينا. إذا كان الرمز المميز صحيحاً بالتأكيد ولا يزال يفشل، فانتظر دقيقة وحاول مرة أخرى، ثم اتصل بالدعم.

“بوت Viber هذا متصل بالفعل بحساب آخر” #

البوت نفسه مرتبط بحساب مختلف في التطبيق. قم بقطع الاتصال به هناك أولاً، أو استخدم بوت مختلفاً.

البوت لا يرد #

• تأكد من أن البطاقة تظهر حالة متصل، وليس متصل، يلزم اتخاذ إجراء.
• تأكد من أن الشخص الذي تختبر معه قد تابع البوت الخاص بك. لا يقوم Viber بتسليم الرسائل إلا من المتابعين.
• تحقق من تعيين وكيل ذكاء اصطناعي (AI Agent) لهذه القناة.

توقف وصول الرسائل #

هذه المشكلة هي دائماً مشكلة السيطرة الموضحة تحت التحقق من حالة الاتصال: تم ربط نفس البوت بأداة أخرى. افتح بطاقة Viber وأعد الاتصال.

فشل الرد مع رسالة “غير مشترك” (Not Subscribed) #

قام الشخص بإلغاء متابعة البوت الخاص بك أو حظره. لا يمكنك مراسلتهم حتى يقوموا بمتابعته مرة أخرى وإرسال رسالة إليك أولاً.

أفضل الممارسات #

• ابدأ بالدعم، وليس بالتواصل الاستباقي. الردود داخل محادثة بدأها شخص ما مجانية وغير محدودة؛ الرسائل التي تبدأها أنت تكون مدفوعة ولا تصل إلا للمتابعين.
• اجعل متابعة البوت الخاص بك أمراً سهلاً. ضع رابطه على موقعك، وفي توقيع بريدك الإلكتروني، وفي قنواتك الأخرى. المتابعة هي الطريقة الوحيدة التي يمكن للناس من خلالها الوصول إليه.
• حافظ على أمان رمز المصادقة (auth token) الخاص بك. يمكن لأي شخص لديه هذا الرمز الإرسال باسم البوت الخاص بك. أعد إنشاء الرمز في تطبيق Viber إذا تم تسريبه، ثم أعد الاتصال هنا.
• لا تربط نفس البوت بأداتين. الأداة الثانية ستتولى السيطرة بصمت.