WhatsApp en Activepieces: Catch Webhook y Send HTTP request con ZapZap

Paso a paso

1. 1

   Crea el flujo con el disparador Catch Webhook

   Crea un flujo nuevo y elige el disparador Webhook > Catch Webhook, que acepta cualquier método HTTP. Copia la URL que muestra el disparador. Para probar, dispara un evento real (por ejemplo, la prueba de webhook de ZapZap, POST /instances/{id}/webhook/test) y mira la ejecución del flujo.

2. 2

   Registra la URL en la instancia de ZapZap

   Llama a PUT https://api.zapzapapi.com/api/v1/instances/{id}/webhook con webhook_url (la URL del paso anterior, en HTTPS) y events (por ejemplo, messages). Cabeceras x-api-key y x-api-secret, de Settings > API. Los eventos vienen desactivados por defecto: pide solo los que vas a usar.

3. 3

   Lee el cuerpo del evento

   El envelope trae delivery_id, event_id, version, instance_id, instance_name, event y data. Usa los campos en los pasos siguientes del flujo. Usa delivery_id para no tratar la misma entrega dos veces.

4. 4

   Envía la respuesta con Send HTTP request

   Agrega la acción HTTP > Send HTTP request. Método POST, URL https://api.zapzapapi.com/api/v1/{instanceId}/send/text, cabeceras x-api-key, x-api-secret y Content-Type application/json, cuerpo JSON con number y text. Guarda los valores de las cabeceras en una conexión o variable del proyecto en vez de escribirlos en cada flujo.

5. 5

   Maneja los fallos

   Si la respuesta es 429 o 5xx, reintenta más tarde; 400, 401 y 403 indican un error de configuración y repetir no lo resuelve. Prueba primero el mismo envío con curl (ejemplo abajo).

# 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"}'