API de WhatsApp paso a paso: de la cuenta al primer mensaje
Usar una API de WhatsApp parece cosa de equipos grandes de tecnología, pero el camino hasta el primer mensaje tiene pocas etapas. En esta guía creas la cuenta, conectas un número, obtienes las claves y haces una prueba. Al final, ves cómo crecer sin poner el número en riesgo.
Este artículo también está disponible en: Português · English
Etapa 1: crea la cuenta y entiende el costo
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 y la información sobre el crédito para probar, así que revísala antes de decidir.
Si eres desarrollador, empieza las pruebas con un número tuyo como destino antes de hablar con clientes reales.
Etapa 2: crea la instancia y conecta el número
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 conversaciones reales. 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.
Etapa 3: obtén la clave, el secreto y el ID de la instancia
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.
Etapa 4: prueba la autenticación
Antes de enviar, confirma que la clave y el secreto funcionan consultando los datos de tu cuenta.
GET /account
curl https://api.zapzapapi.com/api/v1/account \
-H "x-api-key: SUA_API_KEY" \
-H "x-api-secret: SEU_API_SECRET"Etapa 5: envía el primer mensaje
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.
POST /send/text
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."}'Etapa 6: recibe las respuestas con un webhook
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.
Antes de escalar: qué protege tu número
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.
Resumen rápido
- Son seis etapas: cuenta, instancia, claves, prueba de autenticación, primer mensaje y webhook.
- La instancia es el número conectado por código QR, y la configuración toma pocos minutos.
- El costo es por número activo al mes, prepago, sin cobro por mensaje.
- Empieza con un número tuyo y solo después habla con clientes.
- Escala despacio y solo a quien aceptó recibir: no existe garantía contra el bloqueo.
Sigue leyendo
Lee también
Preguntas frecuentes
¿Cómo empezar a usar una API de WhatsApp?
Crea la cuenta, conecta un número por código QR (la instancia), obtén la clave y el secreto de la API en el panel y haz una llamada de envío. La guía muestra cada etapa con el comando listo.
¿Necesito saber programar para usar la API?
Para llamar a la API directamente, sí, lo básico de HTTP. Si no programas, herramientas como n8n y Make hacen la misma llamada de forma visual. Mira la página de [integraciones](/integracoes).
¿Cuánto tarda el primer mensaje?
Después del registro, conectar el número por código QR y probar el envío suele tomar pocos minutos.
¿Puedo usar mi número personal?
Técnicamente sí, pero lo recomendado es un número dedicado al negocio. Usa un número que controlas y que ya tenga conversaciones reales, y nunca envíes en masa a quien no lo pidió.
Empieza ahora
Crea tu cuenta, conecta un número en minutos y prueba la API con calentamiento y anti-bloqueo. R$15 por número activo/mes, prepago, sin permanencia.