Přeskočit obsah

Counterbat API: Viber Bot Billing Sessions

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

Counterbat API vám umožňuje sledovat data relace v reálném čase a využít Cascade API k odesílání dalších zpráv do relace služby nebo již zaplacené relace Viber Bota.

Jak připojit službu Billing Counter

  1. Podepište smlouvu.
  2. Získejte přístup k funkcím.
  3. Nastavte webhook.
  4. Použijte panel a možnosti rozhraní Cascade API.

Viber REST API (Counterbat Edition)

Následuje kompletní reference Viber REST API. Všimněte si, že koncový bod https://chatapi.viber.com je nahrazen https://api.counterbat.com/ pro použití s funkcí Counterbat.

Začněte

K implementaci API budete potřebovat: 1. Aktivní účet Viber na platformě, která podporuje roboty (iOS/Android). 2. Aktivní bot. 3. Token pro ověření účtu. 4. Nastavte webhook účtu.

Autentizační token

Každý požadavek API musí obsahovat záhlaví HTTP s názvem „X-Viber-Auth-Token“ obsahující ověřovací token účtu. 

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

Webhooky

Nastavení webhooku

Adresa URL zdroje

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

Údaje o příspěvku

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

Odebírání webhooku

Chcete-li webhook zakázat, odešlete požadavek set_webhook s prázdným řetězcem adresy URL. 

{
   "url": ""
}

Odeslat zprávu

Rozhraní API send_message umožňuje účtům odesílat zprávy uživatelům Viber, kteří se přihlásí k účtu.

Adresa URL zdroje

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

Příklad odpovědi

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

Klávesnice

Rozhraní API umožňuje odeslání vlastní klávesnice pomocí rozhraní API send_message, které uživateli poskytne sadu předdefinovaných odpovědí nebo akcí.

Adresa URL zdroje

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

Vysílat zprávu

Rozhraní API broadcast_message umožňuje účtům odesílat zprávy více uživatelům Viber, kteří se přihlásí k účtu. Maximální délka seznamu je 300 přijímačů.

Adresa URL zdroje

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

Získejte informace o účtu

Požadavek get_account_info načte podrobnosti účtu tak, jak byly zaregistrovány.

Adresa URL zdroje

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

Získejte podrobnosti o uživateli

Požadavek get_user_details načte podrobnosti konkrétního uživatele Viber na základě jeho jedinečného ID uživatele.

Adresa URL zdroje

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

Získejte online

Požadavek get_online načte online stav daného člena přihlášeného účtu (až 100 uživatelských ID na požadavek).

Adresa URL zdroje

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

Zpětná volání

Viber nabízí zpětná volání pro události, jako jsou subscribed, unsubscribed, conversation_started, delivered, ,seeen, ,failed a ,message. Zpětné volání bude odesláno na adresu URL poskytnutou během voláníset_webhook`.