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
- Obtenha com o responsável pelo sistema receptor uma URL HTTPS que aceite o evento de teste e o formato combinado.
- Informe Nome da integração, URL de destino e Eventos (um por linha), conforme o formulário.
- Preencha o segredo quando a integração usar assinatura e ajuste o tempo limite.
- Salve e use Testar conexão. O Omnichannel envia uma requisição POST real com o evento integration.test para a URL configurada.
- Confira o recebimento no sistema de destino. Quando há segredo, valide a assinatura HMAC-SHA256 enviada no cabeçalho X-Omnichannel-Signature.
- 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.