API de WhatsApp paso a paso: de la cuenta al primer mensaje

El registro se hace en el panel de ZapZap. El modelo es prepago: agregas saldo y pagas por número activo al mes, sin cobro por mensaje y sin permanencia. La página de precios muestra el valor actual. Al crear la cuenta y verificar tu teléfono, recibes un crédito de bienvenida para probar sin depositar (uno por teléfono, sujeto a la campaña vigente).

Si eres desarrollador, empieza las pruebas con un número tuyo como destino antes de hablar con clientes reales.

Instancia es el nombre que damos a cada número de WhatsApp conectado. En el panel, crea una instancia y escanea el código QR con la aplicación de WhatsApp del número que se usará, igual que al conectar WhatsApp Web. La conexión toma pocos minutos.

Usa un número que controlas y que ya tenga historial de uso. Un número recién creado y sin uso es el más vulnerable al bloqueo. Si vas a empezar con un chip nuevo, pasa antes por el calentamiento del número.

En el panel, en Configuración y API, están la clave (x-api-key) y el secreto (x-api-secret). El ID de la instancia aparece en la lista de instancias. Estos tres valores identifican y autentican todas las llamadas. La documentación de autenticación explica cada uno.

Antes de enviar, confirma que la clave y el secreto funcionan consultando los datos de tu cuenta.

curl https://api.zapzapapi.com/api/v1/account \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET"

Con la autenticación correcta, el envío es una llamada. Usa tu propio número como destino en la primera prueba. Para el mismo envío en Node.js, Python y PHP, mira la guía enviar un mensaje de WhatsApp por API.

curl -X POST https://api.zapzapapi.com/api/v1/SEU_INSTANCE_ID/send/text \
  -H "Content-Type: application/json" \
  -H "x-api-key: SUA_API_KEY" \
  -H "x-api-secret: SEU_API_SECRET" \
  -d '{"number":"5511999999999","text":"Minha primeira mensagem pela API."}'

Una conversación tiene dos puntas. Para que tu sistema sea avisado cuando el cliente responda, configura un webhook que apunte a una dirección tuya. La documentación de webhooks lista los eventos. Herramientas como n8n y Make reciben ese webhook sin código, mira las integraciones.

Cuando la prueba funcione, resiste las ganas de escribir a toda tu base. Envía solo a quien aceptó recibir, empieza despacio y aumenta poco a poco, varía el texto y observa las respuestas. Ninguna plataforma elimina el riesgo de bloqueo, y quien lo promete está prometiendo algo que no controla. Lo que existe es práctica que reduce la probabilidad, descrita en la guía antibloqueo.

Si llegaste hasta aquí, ya tienes lo que a muchos les toma tiempo armar: un número conectado, la autenticación probada y el primer envío hecho. De aquí en adelante, crece despacio, solo hacia quien quiere recibir, con las protecciones activadas. Abre el panel, crea la instancia y repite estas etapas con tu número.