إنتقل إلى المحتوى الرئيسي

💬 Viber

يتصل PulseHub بـ Viber عبر Viber REST API، باستخدام حساب Viber العام أو بوت Viber.

المتطلبات الأساسية​

حساب Viber Partners على partners.viber.com.

خطوات الإعداد​

1. إنشاء بوت/حساب عام على Viber​

  1. انتقل إلى partners.viber.com
  2. سجّل الدخول بحساب Viber الخاص بك
  3. انقر على Create Bot Account
  4. املأ اسم البوت والوصف والفئة
  5. بعد الإنشاء، تحصل على Auth Token

2. إضافة القناة في PulseHub​

  1. انتقل إلى Channels → Add Channel
  2. اختر Viber
  3. أدخل Auth Token واسم البوت
  4. انقر على Save Channel
  5. انسخ رابط Webhook

3. تسجيل Webhook​

الخيار أ — باستخدام أداة عبر الإنترنت (بدون حاجة لسطر الأوامر): استخدم أي عميل REST مجاني عبر الإنترنت (مثل Reqbin أو Hoppscotch أو Postman web) وأرسل طلب POST:

  • URL: https://chatapi.viber.com/pa/set_webhook
  • Header: Content-Type: application/json
  • Body:
{
    "auth_token": "YOUR_VIBER_AUTH_TOKEN",
    "url": "https://yourdomain.com/webhooks/viber/YOUR_CHANNEL_ID",
    "event_types": ["message", "subscribed", "unsubscribed", "conversation_started"]
}

الخيار ب — باستخدام سطر الأوامر (VPS):

curl -X POST https://chatapi.viber.com/pa/set_webhook \
  -H "Content-Type: application/json" \
  -d '{
    "auth_token": "YOUR_VIBER_AUTH_TOKEN",
    "url": "https://yourdomain.com/webhooks/viber/YOUR_CHANNEL_ID",
    "event_types": ["message", "subscribed", "unsubscribed", "conversation_started"]
  }'

4. الاختبار​

افتح بوت Viber الخاص بك في التطبيق وأرسل رسالة. يجب أن تظهر في PulseHub خلال ثوانٍ.

التحقق من التوقيع​

يوقّع Viber كل webhook باستخدام X-Viber-Content-Signature عبر HMAC-SHA256 مع Auth Token الخاص بك.