وثائق مختصرة

إعداد Telegram

1. افتح Telegram وابحث عن @BotFather.
2. أرسل الأمر /newbot واتبع التعليمات لإنشاء Bot.
3. احصل على Bot Token.
4. في لوحة OwlRespond: أدخل الـ Token واربطه بالـ Tenant/المنشأة.
5. إذا أردت استقبال/إدارة رسائل قناة: أنشئ قناة، ثم أضف البوت كـ Admin.
6. لاستخراج Channel ID: قم بعمل Forward لرسالة من القناة إلى البوت ثم استخرج forward_from_chat.id من التحديثات.

ملاحظة: تفاصيل متقدمة (Groups/Topics/Permissions) ستضاف لاحقاً.

إعداد WhatsApp (الخيار الموصى به: Cloud API)

الخيار الآمن والرسمي هو WhatsApp Cloud API للأعمال عبر Meta.

1. جهّز Meta Business Manager (وقد تحتاج إلى Business Verification).
2. أنشئ تطبيق على Meta Developers وأضف منتج WhatsApp.
3. اربط رقم الأعمال داخل حساب WhatsApp Business (WABA).
4. استخرج القيم التي ستدخلها في لوحة OwlRespond:
   • Phone Number ID
   • WABA ID
   • Access Token (مفضل عبر System User/Token مُدار)
5. اضبط Webhook لإرسال الرسائل الواردة وحالات التسليم إلى OwlRespond.

مهم: الالتزام بسياسات WhatsApp (opt‑in، نافذة 24 ساعة، منع السبام) ضروري لتقليل مخاطر تقييد الرقم.

بديل QR Code (عند عدم دعم Cloud API في بلد العميل)

• حل اضطراري يعتمد ربط جلسة عبر QR Code (مقترن بجهاز/تطبيق).
• هذا الخيار على مسؤولية العميل وقد يحمل مخاطر تقييد الرقم في حال مخالفة السياسات أو الاشتباه بالسبام.