curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
-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}/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)
data = response.json()
print(f"Status: {data['status']}")
print(f"Progresso: {data['progress_percentage']}%")
print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Status: ${data.status}`);
console.log(`Progresso: ${data.progress_percentage}%`);
console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "COMPLETED",
"template": {
"id": 45,
"template_name": "welcome_message",
"language": "es",
"status": "APPROVED"
},
"phone_number": {
"id": 123,
"display_phone_number": "+54 9 223 675-0780",
"verified_name": "Mindo Software"
},
"total_recipients": 3,
"sent_count": 3,
"delivered_count": 2,
"read_count": 1,
"failed_count": 0,
"pending_count": 0,
"progress_percentage": 100.0,
"estimated_time_minutes": 0.4,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": "2025-11-16T21:30:28Z",
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "PROCESSING",
"template": {
"id": 45,
"template_name": "welcome_message",
"language": "es",
"status": "APPROVED"
},
"phone_number": {
"id": 123,
"display_phone_number": "+54 9 223 675-0780",
"verified_name": "Mindo Software"
},
"total_recipients": 100,
"sent_count": 45,
"delivered_count": 30,
"read_count": 10,
"failed_count": 2,
"pending_count": 53,
"progress_percentage": 47.0,
"estimated_time_minutes": 6.0,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": null,
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Envio em massa
Status do envio
Verificar o status e progresso de um envio em massa
GET
/
api
/
v1
/
meta-templates
/
bulk-sends
/
{bulk_send_id}
/
curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
-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}/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)
data = response.json()
print(f"Status: {data['status']}")
print(f"Progresso: {data['progress_percentage']}%")
print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Status: ${data.status}`);
console.log(`Progresso: ${data.progress_percentage}%`);
console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "COMPLETED",
"template": {
"id": 45,
"template_name": "welcome_message",
"language": "es",
"status": "APPROVED"
},
"phone_number": {
"id": 123,
"display_phone_number": "+54 9 223 675-0780",
"verified_name": "Mindo Software"
},
"total_recipients": 3,
"sent_count": 3,
"delivered_count": 2,
"read_count": 1,
"failed_count": 0,
"pending_count": 0,
"progress_percentage": 100.0,
"estimated_time_minutes": 0.4,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": "2025-11-16T21:30:28Z",
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "PROCESSING",
"template": {
"id": 45,
"template_name": "welcome_message",
"language": "es",
"status": "APPROVED"
},
"phone_number": {
"id": 123,
"display_phone_number": "+54 9 223 675-0780",
"verified_name": "Mindo Software"
},
"total_recipients": 100,
"sent_count": 45,
"delivered_count": 30,
"read_count": 10,
"failed_count": 2,
"pending_count": 53,
"progress_percentage": 47.0,
"estimated_time_minutes": 6.0,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": null,
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Descrição
Permite verificar o status atual e o progresso detalhado de um envio em massa. Inclui contadores de mensagens enviadas, entregues, lidas e com falha, além do percentual de progresso.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.
Resposta
string (UUID)
ID único do envio em massa.
string
Status atual do envio. Consulte a tabela de status.
object
object
integer
Total de destinatários do envio.
integer
Número de mensagens enviadas.
integer
Número de mensagens entregues ao destinatário.
integer
Número de mensagens lidas pelo destinatário.
integer
Número de mensagens com falha.
integer
Número de mensagens pendentes de envio.
float
Percentual de progresso do envio (0-100).
float
Tempo estimado de processamento em minutos.
string (ISO 8601)
Data e hora de início do processamento.
null se ainda não iniciou.string (ISO 8601)
Data e hora de conclusão do processamento.
null se não concluído.string (ISO 8601)
Data e hora de criação do envio.
object
curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
-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}/",
headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"}
)
data = response.json()
print(f"Status: {data['status']}")
print(f"Progresso: {data['progress_percentage']}%")
print(f"Enviados: {data['sent_count']}/{data['total_recipients']}")
const bulkSendId = "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c";
const response = await fetch(
`https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/${bulkSendId}/`,
{
headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
}
);
const data = await response.json();
console.log(`Status: ${data.status}`);
console.log(`Progresso: ${data.progress_percentage}%`);
console.log(`Enviados: ${data.sent_count}/${data.total_recipients}`);
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "COMPLETED",
"template": {
"id": 45,
"template_name": "welcome_message",
"language": "es",
"status": "APPROVED"
},
"phone_number": {
"id": 123,
"display_phone_number": "+54 9 223 675-0780",
"verified_name": "Mindo Software"
},
"total_recipients": 3,
"sent_count": 3,
"delivered_count": 2,
"read_count": 1,
"failed_count": 0,
"pending_count": 0,
"progress_percentage": 100.0,
"estimated_time_minutes": 0.4,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": "2025-11-16T21:30:28Z",
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"id": "a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"status": "PROCESSING",
"template": {
"id": 45,
"template_name": "welcome_message",
"language": "es",
"status": "APPROVED"
},
"phone_number": {
"id": 123,
"display_phone_number": "+54 9 223 675-0780",
"verified_name": "Mindo Software"
},
"total_recipients": 100,
"sent_count": 45,
"delivered_count": 30,
"read_count": 10,
"failed_count": 2,
"pending_count": 53,
"progress_percentage": 47.0,
"estimated_time_minutes": 6.0,
"started_at": "2025-11-16T21:30:05Z",
"completed_at": null,
"created_at": "2025-11-16T21:30:00Z",
"created_by": {
"id": 1,
"email": "user@example.com",
"first_name": "John",
"last_name": "Doe"
}
}
{
"detail": "Not found."
}
{
"error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}
Status possíveis
| Status | Descrição |
|---|---|
QUEUED | Envio criado e na fila para processamento |
PROCESSING | Enviando mensagens ativamente |
COMPLETED | Todas as mensagens processadas com sucesso |
PARTIAL | Processado com algumas falhas |
FAILED | Envio falhou completamente |
CANCELLED | Envio cancelado manualmente |
Para ver o detalhe de cada mensagem individual, use o endpoint Mensagens do envio.

