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"
import requests
bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
response = requests.get(
f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/messages/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "delivered", "page": 1, "page_size": 20}
)
data = response.json()
print(f"Total de mensagens: {data['count']}")
for msg in data["results"]:
print(f" {msg['recipient_phone']}: {msg['status']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const params = new URLSearchParams({
status: "delivered",
page: "1",
page_size: "20"
});
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/messages/?${params}`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Total de mensagens: ${data.count}`);
data.results.forEach(msg => {
console.log(` ${msg.recipient_phone}: ${msg.status}`);
});
{
"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
}
]
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Envio em massa
Mensagens do envio
Listar mensagens individuais de um envio em massa
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"
import requests
bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
response = requests.get(
f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/messages/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "delivered", "page": 1, "page_size": 20}
)
data = response.json()
print(f"Total de mensagens: {data['count']}")
for msg in data["results"]:
print(f" {msg['recipient_phone']}: {msg['status']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const params = new URLSearchParams({
status: "delivered",
page: "1",
page_size: "20"
});
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/messages/?${params}`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Total de mensagens: ${data.count}`);
data.results.forEach(msg => {
console.log(` ${msg.recipient_phone}: ${msg.status}`);
});
{
"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
}
]
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
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
string
obrigatório
Sua API Key da Mindo. Formato:
mindo_xxxxxxxxxxxxxxxxxxxxxxxxParâmetros de path
string (UUID)
obrigatório
ID do envio em massa obtido ao criar o envio com Envio em massa.
Parâmetros de query
string
Filtrar por status da mensagem. Valores possíveis:
sent, delivered, read, failed.integer
Número da página. Padrão:
1.integer
Resultados por página. Padrão:
20.Resposta
integer
Total de mensagens que correspondem aos filtros.
string | null
URL da próxima página de resultados.
null se for a última página.string | null
URL da página anterior.
null se for a primeira página.array
Lista de mensagens individuais.
Mostrar Propriedades de cada mensagem
Mostrar Propriedades de cada mensagem
integer
ID da mensagem.
string
Número de telefone do destinatário.
string
Status atual da mensagem. Consulte a tabela de status.
string
ID da mensagem na Meta/WhatsApp.
object
Variáveis utilizadas para este destinatário.
string (ISO 8601)
Data e hora do envio da mensagem.
string (ISO 8601) | null
Data e hora da entrega.
null se ainda não entregue.string (ISO 8601) | null
Data e hora da leitura.
null se ainda não lida.string | null
Mensagem de erro se o envio falhou.
null se não houve erro.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"
import requests
bulk_send_id = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c"
response = requests.get(
f"https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/{bulk_send_id}/messages/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
params={"status": "delivered", "page": 1, "page_size": 20}
)
data = response.json()
print(f"Total de mensagens: {data['count']}")
for msg in data["results"]:
print(f" {msg['recipient_phone']}: {msg['status']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const params = new URLSearchParams({
status: "delivered",
page: "1",
page_size: "20"
});
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/messages/?${params}`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Total de mensagens: ${data.count}`);
data.results.forEach(msg => {
console.log(` ${msg.recipient_phone}: ${msg.status}`);
});
{
"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
}
]
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Status das mensagens
| Status | Descrição |
|---|---|
sent | Mensagem enviada para a API da Meta |
delivered | Mensagem entregue ao destinatário |
read | Mensagem lida pelo destinatário |
failed | Erro 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.
