Preskočiť na obsah

Counterbat API: Viber Bot Billing Sessions

Možnosti fakturačného počítadla

Counterbat API vám umožňuje monitorovať dáta relácie v reálnom čase a využiť Cascade API na odosielanie ďalších správ do relácie služby alebo už zaplatenej relácie Viber Bot.

Ako pripojiť službu fakturačného pultu

  1. Podpíšte zmluvu.
  2. Získajte prístup k funkciám.
  3. Nastavte si webhook.
  4. Použite panel a možnosti rozhrania Cascade API.

Viber REST API (Counterbat Edition)

Nasleduje úplná referencia Viber REST API. Upozorňujeme, že koncový bod https://chatapi.viber.com je nahradený https://api.counterbat.com/ na použitie s funkciou Counterbat.

Začnite

Na implementáciu API budete potrebovať: 1. Aktívny účet Viber na platforme, ktorá podporuje roboty (iOS/Android). 2. Aktívny bot. 3. Token na overenie účtu. 4. Nastavte webhook účtu.

Overovací token

Každá požiadavka API musí obsahovať hlavičku HTTP s názvom „X-Viber-Auth-Token“, ktorá obsahuje autentifikačný token účtu. 

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

Webhooky

Nastavenie webhooku

Webová adresa zdroja

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

Uverejniť údaje

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

Odstraňuje sa váš webhook

Ak chcete webhook zakázať, odošlite požiadavku set_webhook s prázdnym reťazcom adresy URL. 

{
   "url": ""
}

Odoslať správu

Rozhranie API send_message umožňuje účtom odosielať správy používateľom Viber, ktorí sa prihlásia na odber účtu.

Webová adresa zdroja

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

Príklad odpovede

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

Klávesnice

Rozhranie API umožňuje odoslanie vlastnej klávesnice pomocou rozhrania API send_message, ktoré používateľovi poskytne sadu preddefinovaných odpovedí alebo akcií.

Webová adresa zdroja

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

Odoslaná správa

Rozhranie API broadcast_message umožňuje účtom odosielať správy viacerým používateľom Viber, ktorí sa prihlásia na odber účtu. Maximálna dĺžka zoznamu je 300 prijímačov.

Webová adresa zdroja

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

Získajte informácie o účte

Požiadavka get_account_info načíta podrobnosti účtu tak, ako sú zaregistrované.

Webová adresa zdroja

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

Získajte podrobnosti o používateľovi

Požiadavka „get_user_details“ získa podrobnosti konkrétneho používateľa Viber na základe jeho jedinečného ID používateľa.

Webová adresa zdroja

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

Získajte online

Požiadavka „get_online“ načíta online stav daného člena predplateného účtu (až 100 ID používateľov na žiadosť).

Webová adresa zdroja

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

Spätné volania

Viber ponúka spätné volanie pre udalosti, ako sú „subscribed“, „unsubscribed“, „conversation_started“, „doručená“, „videná“, „neúspešná“ a „správa“. Spätné volanie bude odoslané na adresu URL poskytnutú počas hovoru set_webhook.