לדלג לתוכן

Counterbat API: הפעלות חיוב של Viber Bot

יכולות מונה חיוב

ה-API של Counterbat מאפשר לך לפקח על נתוני הפעלה בזמן אמת ולמנף את Cascade API לשליחת הודעות נוספות להפעלת שירות או להפעלת Viber Bot בתשלום.

כיצד לחבר את שירות מונה החיובים

  1. חתום על חוזה.
  2. קבל גישה לפונקציונליות.
  3. הגדר webhook.
  4. השתמש בפאנל וביכולות של ה-API של Cascade.

Viber REST API (מהדורת Counterbat)

להלן התייחסות מלאה ל-Viber REST API. שים לב שנקודת הקצה https://chatapi.viber.com מוחלפת בhttps://api.counterbat.com/ לשימוש עם פונקציונליות ה-Counterbat.

התחל

כדי ליישם את ה-API, תצטרך: 1. חשבון Active Viber בפלטפורמה התומכת בוטים (iOS/אנדרואיד). 2. בוט פעיל. 3. אסימון אימות חשבון. 4. הגדרת webhook לחשבון.

אסימון אימות

כל בקשת API חייבת לכלול כותרת HTTP בשם 'X-Viber-Auth-Token' המכילה את אסימון האימות של החשבון. 

X-Viber-Auth-Token: 445da6az1s345z78-dazcczb2542zv51a-e0vc5fva17480im9

Webhooks

הגדרת Webhook

כתובת אתר של משאב

https://api.counterbat.com/pa/set_webhook

נתוני פרסום

{
   "url": "https://my.host.com",
   "event_types": [
      "delivered",
      "seen",
      "failed",
      "subscribed",
      "unsubscribed",
      "conversation_started"
   ],
   "send_name": true,
   "send_photo": true
}

הסרת ה-webhook שלך

כדי להשבית את ה-webhook, פרסם בקשת set_webhook עם מחרוזת URL ריקה. 

{
   "url": ""
}

שלח הודעה

ה-API של send_message מאפשר לחשבונות לשלוח הודעות למשתמשי Viber שנרשמים לחשבון.

כתובת אתר של משאב

https://api.counterbat.com/pa/send_message

דוגמה לתגובה

{
   "status": 0,
   "status_message": "ok",
   "message_token": 5741311803571721087,
   "chat_hostname": "SN-CHAT-05_",
   "billing_status": 1
}

מקלדות

ה-API מאפשר שליחת מקלדת מותאמת אישית באמצעות ה-'send_message' API כדי לספק למשתמש קבוצה של תשובות או פעולות מוגדרות מראש.

כתובת אתר של משאב

https://api.counterbat.com/pa/send_message

שידור הודעה

ה-API של broadcast_message מאפשר לחשבונות לשלוח הודעות למספר משתמשי Viber שנרשמים לחשבון. אורך רשימה מקסימלי הוא 300 מקלטים.

כתובת אתר של משאב

https://api.counterbat.com/pa/broadcast_message

קבל פרטי חשבון

הבקשה 'קבל_חשבון_מידע' תביא את פרטי החשבון כפי שנרשמו.

כתובת אתר של משאב

https://api.counterbat.com/pa/get_account_info

קבל פרטי משתמש

הבקשה 'קבל_משתמש_פרטים' תביא את הפרטים של משתמש Viber ספציפי על סמך מזהה המשתמש הייחודי שלו.

כתובת אתר של משאב

https://api.counterbat.com/pa/get_user_details

היכנס לאינטרנט

בקשת ה-'get_online' תביא את הסטטוס המקוון של חברי חשבון רשום נתון (עד 100 מזהי משתמש לכל בקשה).

כתובת אתר של משאב

https://api.counterbat.com/pa/get_online

התקשרויות חוזרות

Viber מציעה התקשרות חוזרת לאירועים כגון 'נרשם', 'לא נרשם', 'התחלת שיחה', 'נמסר', 'נראה', 'נכשל' ו'הודעה'. ההתקשרות חזרה תפורסם לכתובת ה-URL שסופקה במהלך שיחת ה-'set_webhook'.