Saltar al contenido
API de WhatsAppsin complicaciones

Conecta tu número.
Integra la API.
Envía mensajes.

ZAPPIO es una API de WhatsApp para desarrolladores: envía mensajes con una llamada HTTP y recibe respuestas y estados por webhook. Sin mantener sesiones, reconexiones ni colas por tu cuenta.

  • $0Prueba gratis
  • 50 mensajes
  • Sin tarjeta
  • Sin límite de días

Del QR al webhook · el camino real de un mensaje

  1. QRescaneado
  2. instanciaConectada
  3. API keyzp_••••
  4. POST/api/v1/messages
  5. queued202
  6. delivered✓
  7. read✓✓
  8. webhook200 OK
01 · El trabajo que te ahorras

Puedes construir todo esto.
O escribir una línea.

Conectar WhatsApp a tu producto no termina con el primer mensaje. Todo lo de la izquierda hay que construirlo, operarlo y vigilarlo. Con ZAPPIO, no.

Por tu cuenta14 piezas que mantener
  1. 01Vincular por QR
  2. 02Guardar el estado de autenticación
  3. 03Persistir sesiones
  4. 04Detectar desconexiones
  5. 05Reconectar
  6. 06Re-vincular si WhatsApp cierra sesión
  7. 07Cola de envío
  8. 08Control de concurrencia
  9. 09Subir y enviar multimedia
  10. 10Rastrear sent, delivered y read
  11. 11Reintentos sin duplicar
  12. 12Firmar y entregar webhooks
  13. 13Reintentar webhooks fallidos
  14. 14Vigilar todo a las 3 a. m.
Con ZAPPIO
POST /api/v1/messages
{
  "instance": "ins_01EXAMPLE",
  "to": "5217221234567",
  "type": "text",
  "text": "Tu pedido va en camino."
}
→ 202 Accepted

Listo. Vuelve a construir tu producto.

No vuelvas a escribir lógica de reconexión.sesión persistente · reconexión automática
Usa Idempotency-Key para que un reintento con la misma clave no genere un nuevo envío lógico.Idempotency-Key
Sabes cuándo salió, llegó y fue leído.sent · delivered · read
02 · Funciones

Todo lo necesario para integrar WhatsApp.

Enviar mensajes por API es solo el principio. Estas son las piezas que tu aplicación usa de verdad cuando WhatsApp pasa a ser parte del producto.

Enviarun endpoint

Envía lo que tu aplicación necesite, a personas y a grupos.

  • Texto
  • Imágenes
  • Documentos
  • Audio
  • Video
  • Grupos

Una sola API para todos los formatos. Cambias el contenido, no la integración.

Recibir

Recibe lo que tus clientes responden.

Mensajes entrantes por webhook. En la prueba gratuita, los entrantes no cuentan.

Seguimiento

Sabes qué pasó con cada mensaje.

  • sent10:32:01
  • delivered10:32:03
  • read10:32:08

Estados de entrega y lectura, por mensaje.

Webhooks

Tu servidor recibe eventos, no sondeos.

  • message.delivered
  • message.read
  • message.received

Una URL. Un evento por cada cosa que pasa.

Conexión

Sesiones persistentes y reconexión.

ConectadaReconectandoConectada

La sesión se guarda. Si la conexión se interrumpe, ZAPPIO intenta reconectar sin que toques nada.

Acceso

API keys que tú controlas.

  • Producciónzp_••••••••8f2a
  • Stagingzp_••••••••31c9

Crea, nombra y revoca keys desde el panel.

IdempotenciaIdempotency-Key

Reintenta sin miedo a duplicar.

Si repites la petición con la misma key, no se genera un nuevo envío: recibes el mismo mensaje.

03 · Cómo empezar

Cuatro pasos.
Esto sí lo pruebas hoy.

Sin instalar nada. Todo ocurre desde el panel y tu primera petición HTTP.

  1. Crea tu cuenta

    Te registras sin tarjeta.

  2. Conecta tu número

    Escaneas un QR desde WhatsApp y la instancia queda conectada.

  3. Crea tu API key

    La generas en el panel y la usas en tus peticiones.

  4. Envía tu primer mensaje

    Una petición HTTP. ZAPPIO hace el resto.

04 · API para desarrolladores

Una API diseñada para integrarse, no para estorbar.

Una petición para enviar mensajes por API. Una respuesta inmediata. Los estados y las respuestas llegan solos a tu webhook.

  • JSON simple y autenticación con Bearer
  • Respuesta 202: el mensaje ya está en cola
  • Idempotency-Key: un reintento no genera un nuevo envío
Petición · cURLPOST /api/v1/messages
curl -X POST "$ZAPPIO_URL/api/v1/messages" \
  -H "Authorization: Bearer zp_••••••••8f2a" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-4821" \
  -d '{
    "instance": "ins_01EXAMPLE",
    "to": "5217221234567",
    "type": "text",
    "text": "Tu pedido #4821 va en camino."
  }'
Respuesta202 Accepted
{ "data": { "id": "msg_01K8DJ92Q4", "status": "queued", … } }

Qué pasa después de la 202

msg_01K8DJ92Q4
queuedsentdeliveredreadwebhook → tu servidor
# Lo que recibe tu servidor
POST https://tu-app.com/webhooks/zappio
{ "type": "message.read",
  "data": { "message": { "id": "msg_01K8DJ92Q4" } } }
Tu endpoint responde con un 2xx y listo.ZAPPIO te manda un evento por cada cosa que pasa: entrega, lectura o un mensaje nuevo de tu cliente.
05 · Conexión y reintentos

Las conexiones pueden interrumpirse. ZAPPIO se encarga de recuperarlas.

ZAPPIO guarda la sesión, intenta reconectar, mantiene el estado de cada instancia, te envía eventos y reintenta cuando corresponde. Si WhatsApp pide un QR nuevo, lo ves en el panel.

Si la conexión se interrumpe

Reconexión automática

ZAPPIO intenta reconectar con la sesión guardada y reintenta los envíos pendientes. El estado de la instancia lo ves en el panel.

Si WhatsApp cierra la sesión

Sesión desvinculada
WhatsApp desvinculó este dispositivo.Vuelve a conectarlo escaneando un QR nuevo.

Eso no se puede reconectar solo: lo ves en el panel y lo resuelves escaneando un QR.

  • SesiónPersistenteEl estado de autenticación se guarda; no vuelves a escanear en cada reinicio.
  • ColaAsíncronaRespondemos 202 y el mensaje sale en segundo plano; sigues su estado por webhook o consulta.
  • ReintentoIdempotenteCon Idempotency-Key, repetir la misma petición devuelve el mismo mensaje.
  • WebhookCon reintentosSi tu servidor no responde, ZAPPIO reintenta la entrega cuando corresponde.
06 · Precios

Empieza gratis.
Sigue por $399 al mes.

Un solo plan, en pesos y con IVA incluido. No cobramos por mensaje.

Empieza aquí

Prueba

Sin tarjeta
$0MXN
  • 50 mensajes salientes
  • 1 instancia con tu número real
  • Sin límite de días: termina al usar los 50
  • Los mensajes entrantes no cuentan
Crear cuenta gratis

ZAPPIO

Cuando estés listo
$399MXN / mesIVA incluido
1 instancia = 1 número conectadoGrupos, chats, keys y webhooks no cuentan como instancias.
  • Mensajes ilimitados*
  • Todo lo de la prueba, sin tope de 50
  • Cancela cuando quieras. El acceso continúa hasta el final de tu periodo pagado.

Contratas desde tu panel; tu instancia, keys y webhooks siguen igual.

Incluido en la prueba y en el plan

  • API REST y webhooks
  • Texto, multimedia y grupos
  • Mensajes entrantes
  • Estados de entrega y lectura
  • API keys
  • Idempotencia
  • Sesión persistente y reconexión
  • Panel de control

* No cobramos por mensaje; aplicamos límites técnicos razonables para proteger tu número y la plataforma.

07 · Preguntas frecuentes

Preguntas frecuentes

Respuestas cortas, basadas en lo que ZAPPIO hace hoy.

¿Necesito tarjeta para probar ZAPPIO?

No. Creas tu cuenta y empiezas a enviar sin tarjeta.

¿Cuánto dura la prueba?

No expira por días: termina cuando usas tus 50 mensajes salientes. Los entrantes no cuentan.

¿Cómo conecto mi número?

Escaneas un código QR desde WhatsApp y tu instancia queda conectada.

¿Puedo enviar multimedia?

Sí. Además de texto, puedes enviar imágenes, documentos, audio y video.

¿Puedo trabajar con grupos?

Sí, puedes enviar mensajes a grupos. Un grupo no cuenta como instancia.

¿Qué pasa si la conexión se interrumpe?

ZAPPIO intenta reconectar con la sesión guardada. Si WhatsApp cierra la sesión, verás en el panel que necesitas escanear un QR nuevo.

¿Cómo recibo eventos de mensajes?

Configuras una URL de webhook y ZAPPIO te envía los mensajes entrantes y los estados de entrega y lectura.

¿Cuánto cuesta después de la prueba?

$399 MXN al mes, IVA incluido, con 1 instancia. Sin cobro por mensaje.

Ya viste cómo funciona.
Ahora manda el primero.

  • 50 mensajes
  • Sin tarjeta
  • Sin límite de días