Como configurar um webhook
Atualizado em
No SyBox, isso é feito em Definições > Integrações > Webhooks.
- Acesse Definições > Integrações > Webhooks.
- Clique em "Adicionar webhook".
- Insira o "Nome".
- Preencha a "URL do destino". O campo exige "Um endereço https público que possamos alcançar". Links em http comum ou IPs internos de rede local são rejeitados.
- Na seção "Eventos", selecione ao menos uma das opções ("Mensagem recebida" já vem marcada).
- Opcional: marque "Transcrição de voz" se quiser receber o áudio já convertido em texto.
- Em "Números", mantenha "Todos os números" para escutar todas as linhas ou desmarque para apontar números específicos.
- Clique em Salvar.
- A tela exibirá a "Chave de assinatura". "Copie agora — só é mostrada uma vez" e guarde-a no seu ambiente.
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.