Zum Inhalt

Counterbat API: Viber Bot-Abrechnungssitzungen

Abrechnungszählerfunktionen

Mit der Counterbat-API können Sie Sitzungsdaten in Echtzeit überwachen und die Cascade-API nutzen, um zusätzliche Nachrichten in eine Servicesitzung oder eine bereits bezahlte Viber Bot-Sitzung zu senden.

So verbinden Sie den Abrechnungsschalterdienst

  1. Unterzeichnen Sie einen Vertrag.
  2. Erhalten Sie Zugriff auf die Funktionalität.
  3. Richten Sie einen Webhook ein.
  4. Nutzen Sie das Panel und die Funktionen der Cascade API.

Viber REST API (Counterbat Edition)

Das Folgende ist eine vollständige Viber REST API-Referenz. Beachten Sie, dass der Endpunkt „https://chatapi.viber.com“ zur Verwendung mit der Counterbat-Funktionalität durch „https://api.counterbat.com/“ ersetzt wird.

Beginnen Sie

Um die API zu implementieren, benötigen Sie: 1. Ein aktives Viber-Konto auf einer Plattform, die Bots unterstützt (iOS/Android). 2. Aktiver Bot. 3. Kontoauthentifizierungstoken. 4. Richten Sie den Konto-Webhook ein.

Authentifizierungstoken

Jede API-Anfrage muss einen HTTP-Header namens „X-Viber-Auth-Token“ enthalten, der das Authentifizierungstoken des Kontos enthält. 

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

Webhooks

Einen Webhook setzen

Ressourcen-URL

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

Daten posten

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

Entfernen Ihres Webhooks

Um den Webhook zu deaktivieren, senden Sie eine „set_webhook“-Anfrage mit einer leeren URL-Zeichenfolge. 

{
   "url": ""
}

Nachricht senden

Mit der „send_message“-API können Konten Nachrichten an Viber-Benutzer senden, die das Konto abonnieren.

Ressourcen-URL

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

Antwortbeispiel

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

Tastaturen

Die API ermöglicht das Senden einer benutzerdefinierten Tastatur mithilfe der API „send_message“, um dem Benutzer eine Reihe vordefinierter Antworten oder Aktionen bereitzustellen.

Ressourcen-URL

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

Broadcast-Nachricht

Mit der „broadcast_message“-API können Konten Nachrichten an mehrere Viber-Benutzer senden, die das Konto abonnieren. Die maximale Listenlänge beträgt 300 Empfänger.

Ressourcen-URL

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

Kontoinformationen abrufen

Die Anfrage „get_account_info“ ruft die registrierten Kontodetails ab.

Ressourcen-URL

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

Benutzerdetails abrufen

Die Anfrage „get_user_details“ ruft die Details eines bestimmten Viber-Benutzers basierend auf seiner eindeutigen Benutzer-ID ab.

Ressourcen-URL

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

Online gehen

Die „get_online“-Anfrage ruft den Online-Status eines bestimmten abonnierten Kontomitglieds ab (bis zu 100 Benutzer-IDs pro Anfrage).

Ressourcen-URL

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

Rückrufe

Viber bietet Rückrufe für Ereignisse wie „abonniert“, „abbestellt“, „Gespräch_gestartet“, „zugestellt“, „gesehen“, „fehlgeschlagen“ und „Nachricht“. Der Rückruf wird an die URL gesendet, die während des „set_webhook“-Aufrufs angegeben wurde.