Mensagens recebidas (retornos de chamada)
Quando os usuários enviam uma mensagem recebida para o seu bot Viber ou outros canais configurados, o SMSBAT encaminha essas mensagens para o seu servidor via Webhook (Callback).
Formato de webhook
Os retornos de chamada são enviados para o URL do Webhook configurado por meio de uma solicitação HTTP POST com uma carga JSON.
Exemplo de corpo de solicitação
{
"idUuid": "123e4567-e89b-12d3-a456-426614174000",
"alphaName": "ViberBotName",
"phoneNumber": "380936670003",
"text": "Hello, I need help with my order",
"dt": "2025-01-20T14:30:00.000Z"
}
Parâmetros
| Campo | Tipo | Descrição |
|---|---|---|
idUuid | corda | Identificador único da mensagem recebida |
alfaNome | corda | O nome da sua marca/bot que recebeu a mensagem |
número de telefone | corda | Número de telefone do remetente |
texto | corda | O conteúdo do texto da mensagem recebida |
dt | datahora | Carimbo de hora de quando a mensagem foi recebida |
Configuração
Para começar a receber mensagens recebidas:
- Forneça seu URL do Webhook (HTTPS necessário) ao seu gerente de conta SMSBAT ou configure-o no painel.
- Seu endpoint deve aceitar solicitações POST com
Content-Type: application/json. - Seu servidor deve responder com
200 OKao receber a carga útil com sucesso.
Nota: Se o seu servidor não responder com
200 OKou expirar, o SMSBAT pode tentar tentar novamente a entrega com base na configuração da sua conta.