Inicio rápido: de la cuenta al primer mensaje

Cambia las claves de ejemplo por las tuyas, en Configuración y API del panel, y {instanceId} por el ID de la instancia.

1. Paso 1

   Consigue tus claves de API

   En el panel, en Configuración y API, copia la clave y el secreto. Toda solicitud lleva los encabezados x-api-key y x-api-secret.

   Autenticación

2. Paso 2

   Consulta el costo de crear una instancia

   Antes de crear, consulta la tarifa de activación, el valor proporcional y el saldo necesario.

   curl

   curl https://api.zapzapapi.com/api/v1/instances/cost \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET"

   Costo de creación

3. Paso 3

   Crea la instancia

   El nombre acepta solo letras, números, _ y -. Al crearla se descuenta de tu saldo la tarifa de activación y el valor proporcional del mes. La instancia nace con estado PENDING.

   curl

   curl -X POST https://api.zapzapapi.com/api/v1/instances \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET" \
     -H "Content-Type: application/json" \
     -d '{"name":"mi-instancia"}'

   Crear instancia

4. Paso 4

   Conecta el número leyendo el QR

   Pide el QR de la instancia y léelo con el celular, en WhatsApp, Dispositivos vinculados. También puedes conectar desde el panel.

   curl

   curl https://api.zapzapapi.com/api/v1/instances/{id}/qrcode \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET"

   QR de la instancia

5. Paso 5

   Confirma que la instancia está conectada

   Consulta los detalles de la instancia y espera el estado CONNECTED.

   curl

   curl https://api.zapzapapi.com/api/v1/instances/{id} \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET"

   Detalles de la instancia

6. Paso 6

   Envía el primer mensaje

   El número lleva el código del país, por ejemplo 5511999999999. El envío muestra el indicador de escritura automático antes de entregar.

   curl

   curl -X POST https://api.zapzapapi.com/api/v1/{instanceId}/send/text \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET" \
     -H "Content-Type: application/json" \
     -d '{"number":"5511999999999","text":"¡Hola! ¿Cómo estás?"}'

   Enviar texto

7. Paso 7

   Recibe eventos por webhook

   Indica una URL pública en HTTPS para recibir mensajes, estado de entrega y cambios de conexión. Después envía un evento de prueba y revisa las entregas recientes.

   curl

   curl -X PUT https://api.zapzapapi.com/api/v1/instances/{id}/webhook \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET" \
     -H "Content-Type: application/json" \
     -d '{"webhook_url":"https://example.com/webhook"}'
   
   curl -X POST https://api.zapzapapi.com/api/v1/instances/{id}/webhook/test \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET"
   
   curl https://api.zapzapapi.com/api/v1/instances/{id}/webhook/deliveries \
     -H "x-api-key: TU_API_KEY" \
     -H "x-api-secret: TU_API_SECRET"

   Configurar webhook