Como realizar um teste de envio
Atualizado em
No SyBox, isso é feito em Definições > Integrações > Webhooks.
- Certifique-se de que o webhook está ativado. Se estiver desativado, você verá "Ative este webhook primeiro."
- No cartão dele, clique em "Enviar evento de teste". Você verá "Um evento de teste está a caminho. O resultado aparece em Entregas."
- Alguns segundos depois, a lista "Entregas" se abre e mostra a resposta do seu servidor. O cartão também exibirá a última resposta retornada pelo seu sistema com o horário exato. Retornos positivos (ex.: "HTTP 200") aparecem em verde, e falhas em vermelho. A mensagem "Último envio: nunca" indica ausência de registros prévios.
Um evento de teste tem "event": "test" e não carrega dados de clientes. Você pode enviar um a cada poucos segundos; se tentar antes, verá "Um teste foi enviado há instantes. Tente novamente em alguns segundos."
Perguntas
Perdi minha chave de assinatura do webhook.
O segredo não pode ser recuperado visualmente. Edite o webhook, digite uma nova chave arbitrária em "Chave de assinatura", salve e configure essa mesma credencial no seu código.
Meu webhook foi desativado e não fui eu.
O SyBox o desativou depois que o seu servidor falhou 20 vezes seguidas por mais de uma hora. Veja "Desativado sozinho" acima: corrija o seu servidor e ative o webhook novamente dentro de 24 horas para que os eventos pendentes sejam enviados.
O webhook não registra nenhum envio.
Primeiro clique em "Enviar evento de teste" no cartão dele e olhe em "Entregas". Depois cheque estas quatro etapas: (1) O webhook está ativado; (2) Ao menos um evento foi selecionado; (3) O filtro inclui o número certo de WhatsApp ou "Todos os números"; (4) O canal pelo qual a mensagem chegou é um dos canais atendidos pelos webhooks (WhatsApp, Messenger, Instagram, Telegram, TikTok ou Chat ao vivo; não e-mail nem SMS). Por fim, analise o retorno da última tentativa gravado no cartão.
O status do envio acusa falha com HTTP 404 ou 500 em vermelho.
O SyBox conseguiu contatar o seu servidor, mas o seu endpoint retornou um erro interno. Verifique o caminho da rota e consulte os logs da sua aplicação.
Não consigo salvar um webhook por falta de permissão.
Para cadastrar ou ligar um webhook, seu usuário precisa simultaneamente das permissões "Gerenciar canais" e "Mostrar o número do contato". Contate o administrador da sua conta.
Mais sobre Webhooks.