OmnichannelCentral de conhecimento
Integrações e backups

Cadastrar webhooks de integração

Prepare o conector Webhooks e confira seu estado antes de utilizá-lo.

Onde encontrarConfigurações → Integrações → Webhooks

Antes de começar

  • Entre com uma conta autorizada para esta tela.
  • Confira se o módulo está disponível na sua instalação.

Passo a passo

  1. Obtenha com o responsável pelo sistema receptor uma URL HTTPS que aceite o evento de teste e o formato combinado.
  2. Informe Nome da integração, URL de destino e Eventos (um por linha), conforme o formulário.
  3. Preencha o segredo quando a integração usar assinatura e ajuste o tempo limite.
  4. Salve e use Testar conexão. O Omnichannel envia uma requisição POST real com o evento integration.test para a URL configurada.
  5. Confira o recebimento no sistema de destino. Quando há segredo, valide a assinatura HMAC-SHA256 enviada no cabeçalho X-Omnichannel-Signature.
  6. Confirme separadamente quais eventos operacionais estão vinculados ao cadastro utilizado pela instalação. O recebimento do teste não comprova a entrega de todos esses eventos.

Resultado esperado

A configuração fica salva e o teste informa o resultado da conexão.

Observações importantes

  • Webhooks usam o endereço do sistema receptor da empresa. Não existe um painel externo único para cadastrar todos os destinos.
  • O teste envia integration.test; não utiliza uma mensagem real de cliente.
  • Este cadastro de saída é diferente do webhook que recebe mensagens e status da Meta ou do Telegram.
  • Quando a instalação também usa Administração → Webhooks, confira com o responsável qual cadastro efetivamente entrega os eventos operacionais.

Se precisar de ajuda

  • Falha de conexão: confira endereço, credenciais, licença e último teste.
  • Não compartilhe tokens ou senhas ao abrir um chamado de suporte.