Generar un token de API y enviar tu primer mensaje por la API

Visión general de la API de Zapini

Zapini ofrece una API REST para integrar WhatsApp con tus sistemas. Con ella puedes enviar mensajes, medios y audios, gestionar contactos y conversaciones, y controlar la automatización. La autenticación se realiza con un token Bearer, y cada token está vinculado a una instancia de WhatsApp.

Paso 1 — Generar un token de API

Accede a la página /tokens en el panel, elige la instancia deseada y genera un nuevo token. El token completo se muestra solo una vez en el momento de la creación, así que cópialo y guárdalo en un lugar seguro.

💡 Consejo: trata el token como una contraseña. Nunca lo expongas en código de frontend, repositorios públicos ni URLs.

Paso 2 — Autenticar las solicitudes

Incluye el token en la cabecera Authorization en todas las llamadas:

Authorization: Bearer {token}
Content-Type: application/json

Paso 3 — Enviar tu primer mensaje

Usa el endpoint de envío de mensajes, indicando el destinatario en formato internacional y el texto:

curl -X POST https://zapini.app/api/v1/messages/send \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "+5511999999999",
    "message": "¡Hola! Este es mi primer mensaje mediante la API de Zapini."
  }'

Una respuesta exitosa devuelve el identificador del mensaje para que puedas seguir su estado:

{
  "success": true,
  "data": {
    "message_id": "550e8400-e29b-41d4-a716-446655440000",
    "status": "pending"
  }
}

Enviar medios

Para enviar una imagen o documento, usa el endpoint de medios con la URL pública del archivo:

curl -X POST https://zapini.app/api/v1/messages/send-media \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "+5511999999999",
    "media_url": "https://ejemplo.com/archivo.jpg",
    "media_type": "image",
    "caption": "Mira nuestra novedad"
  }'

Límites de uso

La API aplica límites de solicitudes para proteger la plataforma. Si recibes respuestas de demasiadas solicitudes, espacia las llamadas e implementa un reintento con espera progresiva. La referencia completa de los endpoints está en la página pública de documentación de la API.