# Como configurar um webhook

No SyBox, isso é feito em Definições > Integrações > Webhooks. 1) Acesse Definições > Integrações > Webhooks. 2) Clique em "Adicionar webhook". 3) Insira o "Nome". 4) 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. 5) Na seção "Eventos", selecione ao menos uma das opções ("Mensagem recebida" já vem marcada). 6) Opcional: marque "Transcrição de voz" se quiser receber o…

## Como configurar um webhook

1. Acesse Definições > Integrações > Webhooks.
   ![Settings, Webhooks: an active webhook with its last result, and the "Add webhook" button](https://www.sybox.io/res/sybox/help/pt/add-a-webhook-1.webp?v=a68865d9)
2. Clique em "Adicionar webhook".
   ![The new webhook window: its name and the address it calls](https://www.sybox.io/res/sybox/help/pt/add-a-webhook-2.webp?v=acd73e99)
3. Insira o "Nome".
4. 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.
5. Na seção "Eventos", selecione ao menos uma das opções ("Mensagem recebida" já vem marcada).
6. Opcional: marque "Transcrição de voz" se quiser receber o áudio já convertido em texto.
7. Em "Números", mantenha "Todos os números" para escutar todas as linhas ou desmarque para apontar números específicos.
8. Clique em Salvar.
9. A tela exibirá a "Chave de assinatura". "Copie agora — só é mostrada uma vez" e guarde-a no seu ambiente.

## Perguntas

**Q: 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.

**Q: 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.

**Q: 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.

**Q: 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.

**Q: 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.

Source: https://www.sybox.io/pt/help/add-a-webhook