API Counterbat: sessioni di fatturazione Viber Bot
Funzionalità di contatore di fatturazione
L'API Counterbat ti consente di monitorare i dati della sessione in tempo reale e sfruttare l'API Cascade per inviare messaggi aggiuntivi in una sessione di servizio o in una sessione Viber Bot già pagata.
Come collegare il servizio di sportello di fatturazione
- Firma un contratto.
- Ottieni l'accesso alla funzionalità.
- Configura un webhook.
- Utilizza il pannello e le funzionalità dell'API Cascade.
API REST di Viber (edizione Counterbat)
Quello che segue è un riferimento completo all'API REST di Viber. Tieni presente che l'endpoint "https://chatapi.viber.com" è sostituito da "https://api.counterbat.com/" da utilizzare con la funzionalità Counterbat.
Inizia
Per implementare l'API, avrai bisogno di: 1. Un account Viber attivo su una piattaforma che supporta i bot (iOS/Android). 2. Bot attivo. 3. Token di autenticazione dell'account. 4. Configura il webhook dell'account.
Token di autenticazione
Ogni richiesta API deve includere un'intestazione HTTP chiamata "X-Viber-Auth-Token" contenente il token di autenticazione dell'account.
Webhook
Impostazione di un webhook
URL della risorsa
Pubblica i dati
CODICE_BLOCCO_2
Rimozione del webhook
Per disabilitare il webhook, pubblica una richiesta set_webhook con una stringa URL vuota.
Invia messaggio
L'API "send_message" consente agli account di inviare messaggi agli utenti Viber che si iscrivono all'account.
URL della risorsa
Esempio di risposta
CODICE_BLOCCO_5
Tastiere
L'API consente di inviare una tastiera personalizzata utilizzando l'API send_message per fornire all'utente una serie di risposte o azioni predefinite.
URL della risorsa
CODICE_BLOCCO_6
Messaggio trasmesso
L'API broadcast_message consente agli account di inviare messaggi a più utenti Viber che si iscrivono all'account. La lunghezza massima dell'elenco è di 300 ricevitori.
URL della risorsa
CODICE_BLOCCO_7
Ottieni informazioni sull'account
La richiesta "get_account_info" recupererà i dettagli dell'account come registrato.
URL della risorsa
Ottieni i dettagli dell'utente
La richiesta "get_user_details" recupererà i dettagli di uno specifico utente Viber in base al suo ID utente univoco.
URL della risorsa
Collegati online
La richiesta "get_online" recupererà lo stato online di un determinato membro dell'account sottoscritto (fino a 100 ID utente per richiesta).
URL della risorsa
Richiamate
Viber offre callback per eventi come "sottoscritto", "non sottoscritto", "conversazione_iniziata", "consegnato", "visto", "non riuscito" e "messaggio". La richiamata verrà pubblicata all'URL fornito durante la chiamata set_webhook.