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:
1. Forneça seu URL do Webhook (HTTPS necessário) ao seu gerente de conta SMSBAT ou configure-o no painel.
2. Seu endpoint deve aceitar solicitações POST com Content-Type: application/json.
3. Seu servidor deve responder com 200 OK ao 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.