API de Counterbat: Sesiones de facturación de Viber Bot
Capacidades del contador de facturación
La API de Counterbat le permite monitorear los datos de la sesión en tiempo real y aprovechar la API de Cascade para enviar mensajes adicionales a una sesión de servicio o a una sesión de Viber Bot ya pagada.
Cómo conectar el servicio de mostrador de facturación
- Firma un contrato.
- Obtenga acceso a la funcionalidad.
- Configurar un webhook.
- Utilice el panel y las capacidades de Cascade API.
API REST de Viber (edición Counterbat)
La siguiente es una referencia completa de la API REST de Viber. Tenga en cuenta que el punto final https://chatapi.viber.com se reemplaza por https://api.counterbat.com/ para usar con la funcionalidad Counterbat.
Empezar
Para implementar la API, necesitará: 1. Una cuenta Active Viber en una plataforma que admita bots (iOS/Android). 2. Bot activo. 3. Token de autenticación de cuenta. 4. Configurar el webhook de la cuenta.
Token de autenticación
Cada solicitud de API debe incluir un encabezado HTTP llamado "X-Viber-Auth-Token" que contiene el token de autenticación de la cuenta.
Webhooks
Configurar un webhook
URL del recurso
Publicar datos
{
"url": "https://my.host.com",
"event_types": [
"delivered",
"seen",
"failed",
"subscribed",
"unsubscribed",
"conversation_started"
],
"send_name": true,
"send_photo": true
}
Eliminando tu webhook
Para deshabilitar el webhook, publique una solicitud set_webhook con una cadena URL vacía.
Enviar mensaje
La API send_message permite que las cuentas envíen mensajes a los usuarios de Viber que se suscriben a la cuenta.
URL del recurso
Ejemplo de respuesta
{
"status": 0,
"status_message": "ok",
"message_token": 5741311803571721087,
"chat_hostname": "SN-CHAT-05_",
"billing_status": 1
}
Teclados
La API permite enviar un teclado personalizado utilizando la API send_message para proporcionar al usuario un conjunto de respuestas o acciones predefinidas.
URL del recurso
Mensaje de difusión
La API broadcast_message permite que las cuentas envíen mensajes a múltiples usuarios de Viber que se suscriban a la cuenta. La longitud máxima de la lista es de 300 receptores.
URL del recurso
Obtener información de la cuenta
La solicitud get_account_info recuperará los detalles de la cuenta tal como están registradas.
URL del recurso
Obtener detalles del usuario
La solicitud get_user_details obtendrá los detalles de un usuario de Viber específico en función de su ID de usuario único.
URL del recurso
Conéctate
La solicitud get_online obtendrá el estado en línea de los miembros de una cuenta suscrita determinada (hasta 100 ID de usuario por solicitud).
URL del recurso
Devoluciones de llamada
Viber ofrece devoluciones de llamada para eventos como "suscrito", "cancelado la suscripción", "conversación_iniciada", "entregado", "visto", "fallido" y "mensaje". La devolución de llamada se publicará en la URL proporcionada durante la llamada set_webhook.