WhatsApp no Activepieces: Catch Webhook e Send HTTP request com a ZapZap

Passo a passo

1. 1

   Crie o fluxo com o gatilho Catch Webhook

   Crie um fluxo novo e escolha o gatilho Webhook > Catch Webhook, que aceita qualquer método HTTP. Copie a URL que o gatilho mostra. Para testar, dispare um evento real (por exemplo, o botão de teste de webhook da ZapZap, POST /instances/{id}/webhook/test) e veja a execução do fluxo.

2. 2

   Cadastre a URL na instância da ZapZap

   Chame PUT https://api.zapzapapi.com/api/v1/instances/{id}/webhook com webhook_url (a URL do passo anterior, em HTTPS) e events (por exemplo, messages). Cabeçalhos x-api-key e x-api-secret, de Settings > API. Eventos vêm desligados por padrão: peça só os que vai usar.

3. 3

   Leia o corpo do evento

   O envelope traz delivery_id, event_id, version, instance_id, instance_name, event e data. Use os campos nos passos seguintes do fluxo. Use delivery_id para não tratar a mesma entrega duas vezes.

4. 4

   Envie a resposta com Send HTTP request

   Adicione a ação HTTP > Send HTTP request. Método POST, URL https://api.zapzapapi.com/api/v1/{instanceId}/send/text, cabeçalhos x-api-key, x-api-secret e Content-Type application/json, corpo JSON com number e text. Guarde os valores dos cabeçalhos em uma conexão ou variável do projeto em vez de digitar em cada fluxo.

5. 5

   Trate falhas

   Se a resposta for 429 ou 5xx, tente de novo mais tarde; 400, 401 e 403 indicam erro de configuração e repetir não resolve. Teste primeiro o mesmo envio com curl (exemplo abaixo).

# What the "Send HTTP request" step does, as a curl you can test first
curl -X POST "https://api.zapzapapi.com/api/v1/INSTANCE_ID/send/text" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ZAPZAP_API_KEY" \
  -H "x-api-secret: $ZAPZAP_API_SECRET" \
  -d '{"number":"5511999999999","text":"Hello! Your booking is confirmed."}'

# Set the webhook on the instance so the Catch Webhook trigger receives events
curl -X PUT "https://api.zapzapapi.com/api/v1/instances/INSTANCE_ID/webhook" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $ZAPZAP_API_KEY" -H "x-api-secret: $ZAPZAP_API_SECRET" \
  -d '{"webhook_url":"https://YOUR-ACTIVEPIECES-WEBHOOK-URL","events":"messages"}'