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 readBasicUpdated on November 12, 2026
Changed on 11/12/2026: Nova área de desenvolvedores com a referência completa da API
Where to find it in Cognizy
Video lesson coming soon. For now, follow the steps below.
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.
Where to find it in 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
- Step 1:
Abra , aba Webhooks, e clique em Novo webhook.
- Step 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.
- Step 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.
- Step 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
Sign in with your Cognizy account to save your progress.
Sign in