Hyppää sisältöön

Counterbat API: Viber Bot Billing Sessions

Laskutuslaskuriominaisuudet

Counterbat API antaa sinun seurata istuntotietoja reaaliajassa ja hyödyntää Cascade APIa lähettääksesi lisäviestejä palveluistuntoon tai jo maksettuun Viber Bot -istuntoon.

Laskutuslaskuripalvelun yhdistäminen

  1. Allekirjoita sopimus.
  2. Pääsy toimintoihin.
  3. Määritä webhook.
  4. Käytä paneelia ja Cascade API:n ominaisuuksia.

Viber REST API (Counterbat Edition)

Seuraava on täydellinen Viber REST API -viite. Huomaa, että päätepiste "https://chatapi.viber.com" korvataan osoitteella "https://api.counterbat.com/" käytettäväksi Counterbat-toiminnon kanssa.

Aloita

Sovellusliittymän käyttöönottamiseksi tarvitset: 1. Active Viber -tili alustalla, joka tukee botteja (iOS/Android). 2. Aktiivinen botti. 3. Tilin todennustunnus. 4. Määritä tilin webhook.

Todennustunnus

Jokaisessa API-pyynnössä on oltava HTTP-otsikko nimeltä "X-Viber-Auth-Token", joka sisältää tilin todennustunnuksen. 

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

Webhooks

Webhookin asettaminen

Resurssin URL-osoite

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

Lähetä tiedot

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

Webhookin poistaminen

Voit poistaa webhookin käytöstä lähettämällä "set_webhook"-pyynnön tyhjällä URL-merkkijonolla. 

{
   "url": ""
}

Lähetä viesti

Send_message-sovellusliittymän avulla tilit voivat lähettää viestejä tilin tilaaville Viber-käyttäjille.

Resurssin URL-osoite

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

Vastausesimerkki

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

Näppäimistöt

API mahdollistaa mukautetun näppäimistön lähettämisen "send_message" API:n avulla, jotta käyttäjä saa joukon ennalta määritettyjä vastauksia tai toimintoja.

Resurssin URL-osoite

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

Lähetysviesti

Broadcast_message-sovellusliittymän avulla tilit voivat lähettää viestejä useille tilin tilaaville Viber-käyttäjille. Listan maksimipituus on 300 vastaanotinta.

Resurssin URL-osoite

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

Hanki tilitiedot

Get_account_info-pyyntö hakee tilin tiedot sellaisina kuin ne on rekisteröity.

Resurssin URL-osoite

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

Hanki käyttäjätiedot

"get_user_details" -pyyntö hakee tietyn Viber-käyttäjän tiedot hänen yksilöllisen käyttäjätunnuksensa perusteella.

Resurssin URL-osoite

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

Hanki online

Get_online-pyyntö hakee tietyn tilatun tilin jäsenten online-tilan (enintään 100 käyttäjätunnusta per pyyntö).

Resurssin URL-osoite

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

Takaisinsoittoja

Viber tarjoaa takaisinsoittoja tapahtumille, kuten tilattu, peruutettu, keskustelu aloitettu, toimitettu, nähty, epäonnistunut ja viesti. Takaisinsoitto lähetetään set_webhook-puhelun aikana annettuun URL-osoitteeseen.