API Counterbat: Sessões de cobrança do Viber Bot
Recursos do contador de cobrança
A API Counterbat permite monitorar os dados da sessão em tempo real e aproveitar a API Cascade para enviar mensagens adicionais para uma sessão de serviço ou uma sessão já paga do Viber Bot.
Como conectar o serviço de contador de cobrança
- Assine um contrato.
- Obtenha acesso à funcionalidade.
- Configure um webhook.
- Use o painel e os recursos da API Cascade.
API REST do Viber (edição Counterbat)
A seguir está uma referência completa da API REST do Viber. Observe que o endpoint https://chatapi.viber.com é substituído por https://api.counterbat.com/ para uso com a funcionalidade Counterbat.
Comece
Para implementar a API, você precisará de: 1. Uma conta Active Viber em uma plataforma que suporta bots (iOS/Android). 2. Bot ativo. 3. Token de autenticação da conta. 4. Configure o webhook da conta.
Token de autenticação
Cada solicitação de API deve incluir um cabeçalho HTTP chamado X-Viber-Auth-Token contendo o token de autenticação da conta.
Webhooks
Configurando um webhook
URL do recurso
Postar dados
{
"url": "https://my.host.com",
"event_types": [
"delivered",
"seen",
"failed",
"subscribed",
"unsubscribed",
"conversation_started"
],
"send_name": true,
"send_photo": true
}
Removendo seu webhook
Para desabilitar o webhook, poste uma solicitação set_webhook com uma string de URL vazia.
CODE_BLOCO_3
Enviar mensagem
A API send_message permite que as contas enviem mensagens para usuários do Viber que assinam a conta.
URL do recurso
Exemplo de resposta
CODE_BLOCO_5
Teclados
A API permite enviar um teclado personalizado usando a API send_message para fornecer ao usuário um conjunto de respostas ou ações predefinidas.
URL do recurso
Mensagem de transmissão
A API broadcast_message permite que as contas enviem mensagens para vários usuários do Viber que assinam a conta. O comprimento máximo da lista é de 300 receptores.
URL do recurso
Obtenha informações da conta
A solicitação get_account_info irá buscar os detalhes da conta conforme registrada.
URL do recurso
Obtenha detalhes do usuário
A solicitação get_user_details irá buscar os detalhes de um usuário específico do Viber com base em seu ID de usuário exclusivo.
URL do recurso
CODE_BLOCO_9
Fique on-line
A solicitação get_online irá buscar o status online de um determinado membro da conta assinada (até 100 IDs de usuário por solicitação).
URL do recurso
Retornos de chamada
O Viber oferece retornos de chamada para eventos como subscribed, unsubscribed, conversation_started, delivered, seen, failed e message. O retorno de chamada será postado na URL fornecida durante a chamada set_webhook.