Skip to main content

​
Ciclo de vida

Cuando enviás un mensaje, pasa por estos estados: 
queued → sent → delivered → read
                    ↘ failed
EstadoSignificado
queuedWaspy recibió la request y el mensaje está en cola
sentEl mensaje fue enviado a los servidores de Meta
deliveredEl mensaje llegó al teléfono del destinatario
readEl destinatario leyó el mensaje (tilde azul)
failedEl envío falló. errorCode y errorMessage tienen el detalle

​
Consultar el estado

curl https://api.waspytech.com/api/v2/messages/MSG_ID \
  -H "Authorization: Bearer wspy_..."

{
  "data": {
    "id": "msg-uuid",
    "status": "delivered",
    "direction": "outbound",
    "type": "text",
    "content": { "text": "Hola!" },
    "errorCode": null,
    "errorMessage": null,
    "createdAt": "2026-04-13T14:32:00.000Z"
  }
}

​
Errores frecuentes

Si un mensaje falla, el campo errorCode contiene el código de error de Meta. Los más comunes:
CódigoCausa
131047El número no tiene WhatsApp
131026El mensaje no se pudo entregar (número bloqueado, etc.)
132000Template no aprobado o parámetros inválidos
131056El negocio no puede enviar (restricción de Meta)

​
Notas

  • El estado read solo se reporta si el destinatario tiene confirmaciones de lectura activadas.
  • Los estados se actualizan vía webhooks de Meta. Puede haber un delay de segundos entre sent y delivered.
  • Los mensajes failed no se reintentan automáticamente.