Como enviar eventos da GoZAP para o n8n?

A GoZAP envia chamadas HTTP POST para os destinos cadastrados. O pacote n8n-nodes-gozap também oferece operações para listar webhooks, substituir a configuração e consultar erros de entrega.

“Valide o payload observado no seu próprio fluxo antes de mapear os campos.”

1. Como preparar o endpoint no n8n?

01No n8n
n8n
Crie um endpoint receptor

Adicione ao workflow um nó capaz de receber chamadas HTTP e copie a URL apresentada pelo seu ambiente n8n. Use a URL de teste durante a inspeção; ao ativar o workflow, atualize a inscrição GoZAP para o endereço de produção informado pelo n8n.

2. Como cadastrar o webhook na GoZAP?

02Na GoZAP
GoZAP
Configure a URL e os eventos

Consulte a configuração atual, selecione as categorias necessárias e salve a lista de webhooks para a instância.

Rotas de webhook por instância

GET /webhook POST /webhook GET /webhook/errors

Também é possível executar as operações de webhook pelo recurso correspondente do pacote n8n-nodes-gozap. As rotas que seu fluxo consulta são:

GET /webhook
POST /webhook
GET /webhook/errors

3. Como conferir os dados recebidos?

03No fluxo
Validação
Inspecione uma execução

Gere um evento correspondente às categorias configuradas e examine a execução no n8n. Os nomes e a estrutura dos campos dependem do evento; use o payload observado na sua versão da API.

4. Como acompanhar erros de entrega?

04Na API GoZAP
Operação
Consulte os erros do webhook

A rota GET /webhook/errors lista erros registrados para a instância. As entregas são enviadas como HTTP POST com JSON. A assinatura HMAC pode ser ativada na configuração do webhook.