Saltar al contenido principal
GET
/
api
/
v1
/
meta-templates
/
bulk-sends
/
{bulk_send_id}
/
messages
/
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/messages/?status=delivered&page=1&page_size=20" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1001,
      "recipient_phone": "+5491112345678",
      "status": "delivered",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgS...",
      "variables_used": {
        "name": "Juan Perez",
        "code": "ABC123"
      },
      "sent_at": "2025-11-16T21:30:10Z",
      "delivered_at": "2025-11-16T21:30:15Z",
      "read_at": null,
      "error_message": null
    },
    {
      "id": 1002,
      "recipient_phone": "+5491187654321",
      "status": "read",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgT...",
      "variables_used": {
        "name": "Maria Garcia",
        "code": "DEF456"
      },
      "sent_at": "2025-11-16T21:30:18Z",
      "delivered_at": "2025-11-16T21:30:23Z",
      "read_at": "2025-11-16T21:30:30Z",
      "error_message": null
    },
    {
      "id": 1003,
      "recipient_phone": "+5491199887766",
      "status": "sent",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgU...",
      "variables_used": {
        "name": "Carlos Lopez",
        "code": "GHI789"
      },
      "sent_at": "2025-11-16T21:30:26Z",
      "delivered_at": null,
      "read_at": null,
      "error_message": null
    }
  ]
}

​
Descripción

Devuelve la lista paginada de mensajes individuales de un envío masivo. Permite filtrar por estado para identificar rápidamente mensajes fallidos, entregados o leídos.

​
Header de autenticación

​
X-API-Key
string
requerido
Tu API Key de Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Parámetros de ruta

​
bulk_send_id
string (UUID)
requerido
ID del envío masivo obtenido al crear el envío con Enviar masivo.

​
Parámetros de query

​
status
string
Filtrar por estado del mensaje. Valores posibles: sent, delivered, read, failed.
​
page
integer
Número de página. Por defecto: 1.
​
page_size
integer
Cantidad de resultados por página. Por defecto: 20.

​
Respuesta

​
count
integer
Total de mensajes que coinciden con los filtros.
​
next
string | null
URL de la siguiente página de resultados. null si es la última página.
​
previous
string | null
URL de la página anterior. null si es la primera página.
​
results
array
Lista de mensajes individuales.
curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/messages/?status=delivered&page=1&page_size=20" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "count": 3,
  "next": null,
  "previous": null,
  "results": [
    {
      "id": 1001,
      "recipient_phone": "+5491112345678",
      "status": "delivered",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgS...",
      "variables_used": {
        "name": "Juan Perez",
        "code": "ABC123"
      },
      "sent_at": "2025-11-16T21:30:10Z",
      "delivered_at": "2025-11-16T21:30:15Z",
      "read_at": null,
      "error_message": null
    },
    {
      "id": 1002,
      "recipient_phone": "+5491187654321",
      "status": "read",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgT...",
      "variables_used": {
        "name": "Maria Garcia",
        "code": "DEF456"
      },
      "sent_at": "2025-11-16T21:30:18Z",
      "delivered_at": "2025-11-16T21:30:23Z",
      "read_at": "2025-11-16T21:30:30Z",
      "error_message": null
    },
    {
      "id": 1003,
      "recipient_phone": "+5491199887766",
      "status": "sent",
      "meta_message_id": "wamid.HBgLNTU0MTE2NzU0Nzg1FQIAERgU...",
      "variables_used": {
        "name": "Carlos Lopez",
        "code": "GHI789"
      },
      "sent_at": "2025-11-16T21:30:26Z",
      "delivered_at": null,
      "read_at": null,
      "error_message": null
    }
  ]
}

​
Estados de mensajes

EstadoDescripción
sentMensaje enviado a la API de Meta
deliveredMensaje entregado al destinatario
readMensaje leído por el destinatario
failedError en el envío
Los estados se actualizan automáticamente mediante webhooks de Meta. El estado progresa de sent → delivered → read. Si el envío falla, el estado será failed y el campo error_message contendrá la descripción del error.