Posso cadastrar mais de um webhook? Sim. Cada webhook tem seu endpoint, seus headers e seus eventos. Um webhook lento ou fora do ar não atrasa os outros.
Posso usar uma URL sem HTTPS? Não. O endpoint precisa ser uma URL HTTPS válida.
Quanto tempo meu endpoint tem para responder? Até 8 segundos, contando a conexão. Responda com qualquer status 2xx.
Recebi o mesmo evento duas vezes. É um erro? Não. A entrega é "pelo menos uma vez", e o mesmo evento pode chegar repetido. Ignore os eventos com um traceId que você já processou.
Os eventos chegam em ordem? Sim, os eventos de uma mesma conversa chegam na ordem em que aconteceram. Conversas diferentes são entregues em paralelo.
Meu endpoint ficou fora do ar. Os eventos são reenviados? Cada evento é tentado até 3 vezes, com cerca de 3 minutos entre as tentativas. Depois disso, ele não é reenviado automaticamente e aparece em Erros recentes.
E se o endpoint ficar fora do ar por horas? Os eventos desse período não são reenviados automaticamente, e as entregas voltam em até cerca de 5 minutos depois que o endpoint responder. Veja a seção "E se o meu endpoint ficar fora do ar por horas?" no artigo Como a entrega funciona.
Como sei se o problema está no meu endpoint? Abra o webhook e veja o Histórico de entregas. Em Erros recentes, o status, o motivo e a Resposta do endpoint mostram o que aconteceu. O artigo Histórico de entregas e erros comuns explica os erros mais frequentes.
Como paro de receber eventos por um tempo? Abra o webhook, desligue Ativo e salve. Os eventos desse período não são enviados depois.
Como sei que a chamada veio da OmniChat? Cadastre um header de autenticação, como Authorization com um token, e valide o valor no seu servidor.
Onde vejo um exemplo do que vou receber? No formulário do webhook, clique em Ver exemplo ao lado do evento. O artigo Referência de eventos e campos traz todos os exemplos.
Já uso os webhooks antigos. Preciso mudar alguma coisa? Não é obrigatório agora. Os webhooks antigos são legado: continuam funcionando, mas as novidades chegam só aqui. Recomendamos cadastrar as novas integrações nesta tela. Veja O que são webhooks na OmniChat.