Pular para o conteúdo 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
    }
  ]
}

​
Descrição

Retorna uma lista paginada de mensagens individuais de um envio em massa. Permite filtrar por status para identificar rapidamente mensagens com falha, entregues ou lidas.

​
Header de autenticação

​
X-API-Key
string
obrigatório
Sua API Key da Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

​
Parâmetros de path

​
bulk_send_id
string (UUID)
obrigatório
ID do envio em massa obtido ao criar o envio com Envio em massa.

​
Parâmetros de query

​
status
string
Filtrar por status da mensagem. Valores possíveis: sent, delivered, read, failed.
​
page
integer
Número da página. Padrão: 1.
​
page_size
integer
Resultados por página. Padrão: 20.

​
Resposta

​
count
integer
Total de mensagens que correspondem aos filtros.
​
next
string | null
URL da próxima página de resultados. null se for a última página.
​
previous
string | null
URL da página anterior. null se for a primeira página.
​
results
array
Lista de mensagens individuais.
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
    }
  ]
}

​
Status das mensagens

StatusDescrição
sentMensagem enviada para a API da Meta
deliveredMensagem entregue ao destinatário
readMensagem lida pelo destinatário
failedErro no envio
Os status são atualizados automaticamente via webhooks da Meta. O status progride de sent → delivered → read. Se o envio falhar, o status será failed e o campo error_message conterá a descrição do erro.