Documentación de ZAPPIO

ZAPPIO es una API de mensajería de WhatsApp para desarrolladores. Conectas un número de WhatsApp a una instancia, envías mensajes con llamadas HTTPS normales y recibes respuestas y estados por webhook. ZAPPIO se encarga de mantener la sesión, intentar reconectar cuando la conexión se interrumpe y reintentar la entrega de tus webhooks.

Empieza aquí

Si es tu primera vez, sigue el Quickstart: de cuenta nueva a primer mensaje enviado, paso a paso, con los comandos para copiar.

Qué puedes hacer

• Enviar texto, imágenes, documentos, audio y video, a personas y a grupos, con un solo endpoint (Enviar mensajes, Multimedia, Grupos).
• Recibir los mensajes que tus clientes responden y los estados sent, delivered y read, por webhook (Webhooks).
• Conectar y supervisar tu número: sesiones persistentes, estado de cada instancia y eventos de conexión (Instancias y conexión).
• Reintentar sin duplicar con Idempotency-Key (Idempotencia).
• Controlar el acceso con API keys y permisos por scope (Autenticación, API keys).

Cómo funciona

1. Creas tu cuenta y conectas tu número escaneando un código QR desde WhatsApp. Eso crea una instancia conectada.
2. Creas una API key en el panel y la usas como Bearer en tus peticiones.
3. Llamas a POST /api/v1/messages. ZAPPIO responde 202 Accepted de inmediato: el mensaje queda en cola y sale en segundo plano.
4. Tu servidor recibe por webhook los cambios de estado (message.delivered, message.read) y los mensajes entrantes (message.received).

Qué necesitas

• Una cuenta de ZAPPIO (la prueba gratuita no pide tarjeta; ver Prueba y planes).
• Un teléfono con WhatsApp en el número que vas a conectar.
• Algo que haga peticiones HTTPS: curl, o el lenguaje de tu aplicación.

Cómo está organizada esta documentación

Sección	Para qué sirve
Guías	Explican cómo usar la API y qué esperar: autenticación, conexión, envío, webhooks, errores y límites.
Referencia API	Cada endpoint con sus parámetros, cuerpos y respuestas. Se genera directamente del contrato OpenAPI.
Eventos	La forma exacta de cada evento que ZAPPIO envía a tu servidor.

El contrato completo está disponible para descargar en openapi.json (OpenAPI 3.1), por ejemplo para importarlo en Postman, Insomnia o un generador de clientes.

Lo que esta API no incluye

La API pública describe solo las operaciones que puedes usar con una API key. Crear tu cuenta, administrar tu espacio de trabajo, tus claves API y tu facturación se hace desde el panel. ZAPPIO no es la API oficial de WhatsApp Business ni está afiliado a Meta Platforms, Inc.; WhatsApp es una marca de Meta.