Gå til indholdet

Counterbat API: Viber Bot Billing Sessions

Muligheder for faktureringstæller

Counterbat API giver dig mulighed for at overvåge sessionsdata i realtid og udnytte Cascade API til at sende yderligere beskeder til en servicesession eller en allerede betalt Viber Bot-session.

Sådan tilsluttes faktureringstællertjenesten

  1. Underskriv en kontrakt.
  2. Få adgang til funktionaliteten.
  3. Opret en webhook.
  4. Brug panelet og funktionerne i Cascade API.

Viber REST API (Counterbat Edition)

Det følgende er en komplet Viber REST API-reference. Bemærk, at slutpunktet https://chatapi.viber.com erstattes af https://api.counterbat.com/ til brug med Counterbat-funktionaliteten.

Kom i gang

For at implementere API'en skal du bruge: 1. En Active Viber-konto på en platform, der understøtter bots (iOS/Android). 2. Aktiv bot. 3. Kontogodkendelsestoken. 4. Opsæt konto webhook.

Godkendelsestoken

Hver API-anmodning skal indeholde en HTTP-header kaldet "X-Viber-Auth-Token", der indeholder kontoens godkendelsestoken.

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

Webhooks

Indstilling af en webhook

Ressource URL

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

Indsend data

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

Fjerner din webhook

For at deaktivere webhook, post en set_webhook anmodning med en tom URL-streng.

{
   "url": ""
}

Send besked

send_message API'et tillader konti at sende beskeder til Viber-brugere, der abonnerer på kontoen.

Ressource URL

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

Svareksempel

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

Tastaturer

API'en tillader at sende et brugerdefineret tastatur ved hjælp af 'send_message' API'et for at give brugeren et sæt foruddefinerede svar eller handlinger.

Ressource URL

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

Udsend besked

broadcast_message API'et tillader konti at sende beskeder til flere Viber-brugere, der abonnerer på kontoen. Maksimal listelængde er 300 modtagere.

Ressource URL

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

Få kontooplysninger

Anmodningen get_account_info vil hente kontooplysningerne som registreret.

Ressource URL

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

Få brugeroplysninger

get_user_details-anmodningen vil hente detaljerne for en specifik Viber-bruger baseret på deres unikke bruger-id.

Ressource URL

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

Kom online

'get_online'-anmodningen henter onlinestatussen for et givet abonnement på kontomedlemmer (op til 100 bruger-id'er pr. anmodning).

Ressource URL

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

Tilbagekald

Viber tilbyder tilbagekald til begivenheder såsom 'abonneret', 'afmeldt', 'samtalestartet', 'leveret', 'set', 'mislykket' og 'besked'. Tilbagekaldet vil blive sendt til den URL, der blev angivet under "set_webhook"-opkaldet.