Skoči na vsebino

Counterbat API: Viber Bot Billing Sessions

Zmogljivosti števca zaračunavanja

Counterbat API vam omogoča spremljanje podatkov o sejah v realnem času in izkoriščanje Cascade API za pošiljanje dodatnih sporočil v storitveno sejo ali že plačano sejo Viber Bot.

Kako povezati storitev obračunskega okenca

  1. Podpišite pogodbo.
  2. Pridobite dostop do funkcionalnosti.
  3. Nastavite webhook.
  4. Uporabite ploščo in zmožnosti API-ja Cascade.

Viber REST API (Counterbat Edition)

Spodaj je popolna referenca API-ja Viber REST. Upoštevajte, da je končna točka https://chatapi.viber.com nadomeščena z https://api.counterbat.com/ za uporabo s funkcijo Counterbat.

Začnite

Za implementacijo API-ja boste potrebovali: 1. Aktiven račun Viber na platformi, ki podpira robote (iOS/Android). 2. Aktivni bot. 3. Žeton za preverjanje pristnosti računa. 4. Nastavite webhook računa.

Žeton za preverjanje pristnosti

Vsaka zahteva API mora vključevati glavo HTTP, imenovano X-Viber-Auth-Token, ki vsebuje žeton za preverjanje pristnosti računa. 

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

Webhooks

Nastavitev Webhooka

URL vira

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

Objavi podatke

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

Odstranjevanje vašega webhooka

Če želite onemogočiti webhook, objavite zahtevo set_webhook s praznim nizom URL. 

{
   "url": ""
}

Pošlji sporočilo

API send_message omogoča računom pošiljanje sporočil uporabnikom Viberja, ki so naročeni na račun.

URL vira

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

Primer odgovora

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

Tipkovnice

API omogoča pošiljanje tipkovnice po meri z uporabo API-ja send_message, da uporabniku zagotovi nabor vnaprej določenih odgovorov ali dejanj.

URL vira

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

Oddajno sporočilo

API broadcast_message omogoča računom pošiljanje sporočil več uporabnikom Viberja, ki so naročeni na račun. Največja dolžina seznama je 300 sprejemnikov.

URL vira

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

Pridobite podatke o računu

Zahteva get_account_info bo pridobila podatke o računu, kot je registriran.

URL vira

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

Pridobite podrobnosti o uporabniku

Zahteva get_user_details bo pridobila podrobnosti določenega uporabnika Viber na podlagi njegovega edinstvenega uporabniškega ID-ja.

URL vira

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

Pojdite na splet

Zahteva get_online bo pridobila spletni status danega naročenega člana računa (do 100 ID-jev uporabnikov na zahtevo).

URL vira

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

Povratni klici

Viber ponuja povratne klice za dogodke, kot so subscribed, unsubscribed, conversation_started, delivered, seen, failed in message. Povratni klic bo objavljen na URL-ju, posredovanem med klicem set_webhook.