Como cadastrar um webhook e aprovar ações das integrações
Receba no seu sistema os eventos do Cognizy em tempo real e aprove as ações que a IA e as integrações pedem antes de executar.
1 min de leituraBásicoAtualizado em 12 de novembro de 2026
Onde fica no Cognizy
Videoaula em breve. Por enquanto, siga o passo a passo abaixo.
Um webhook manda para o endereço do seu sistema cada evento escolhido (conversa nova, contato criado, negócio ganho…), assinado com HMAC-SHA256. Em Aprovações de IA ficam as ações pedidas pela API, pelo MCP e pelos agentes que só executam com o seu OK.
Onde fica no Cognizy
Antes de começar
- Tenha a URL do seu sistema que vai receber os eventos.
- Só o dono e os administradores cadastram webhooks.
Passo a passo
- Passo 1:
Abra , aba Webhooks, e clique em Novo webhook.
- Passo 2:
Informe a URL de destino e uma Descrição. Em Eventos, marque os que o seu sistema quer receber, como contato criado e negócio ganho.
- Passo 3:
Clique em Novo webhook, no fim da janela. As entregas são assinadas com HMAC-SHA256: no seu sistema, sempre confira a assinatura antes de usar o evento.
- Passo 4:
Na aba Aprovações de IA, em Pendentes, ficam as ações pedidas pela API, pelo MCP e pelos agentes que só rodam com aprovação. Abra cada uma, confira e aprove ou recuse.
Como saber que deu certo
O webhook aparece na lista e passa a receber os eventos escolhidos. As ações aprovadas executam na hora; as recusadas não acontecem.
Se der errado
O meu sistema não recebe os eventos.
Confira se a URL é pública (https) e responde com sucesso. Veja as entregas do webhook para o código de erro.
Próximo passo
Crie uma chave de API para chamar o Cognizy.
Para desenvolvedores
Entre com a sua conta Cognizy para salvar o progresso.
Entrar