Pular para o conteúdo principal
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"

{
  "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"
  }
}

​
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

​
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.

​
Resposta

​
id
string (UUID)
ID único do envio em massa.
​
status
string
Status atual do envio. Consulte a tabela de status.
​
template
object
Informações sobre o template utilizado.
​
phone_number
object
Informações sobre o número do WhatsApp remetente.
​
total_recipients
integer
Total de destinatários do envio.
​
sent_count
integer
Número de mensagens enviadas.
​
delivered_count
integer
Número de mensagens entregues ao destinatário.
​
read_count
integer
Número de mensagens lidas pelo destinatário.
​
failed_count
integer
Número de mensagens com falha.
​
pending_count
integer
Número de mensagens pendentes de envio.
​
progress_percentage
float
Percentual de progresso do envio (0-100).
​
estimated_time_minutes
float
Tempo estimado de processamento em minutos.
​
started_at
string (ISO 8601)
Data e hora de início do processamento. null se ainda não iniciou.
​
completed_at
string (ISO 8601)
Data e hora de conclusão do processamento. null se não concluído.
​
created_at
string (ISO 8601)
Data e hora de criação do envio.
​
created_by
object
Usuário que criou o envio.
curl -X GET https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/a3f2b8c9-4d5e-6f7a-8b9c-0d1e2f3a4b5c/ \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

{
  "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"
  }
}

​
Status possíveis

StatusDescrição
QUEUEDEnvio criado e na fila para processamento
PROCESSINGEnviando mensagens ativamente
COMPLETEDTodas as mensagens processadas com sucesso
PARTIALProcessado com algumas falhas
FAILEDEnvio falhou completamente
CANCELLEDEnvio cancelado manualmente
Para ver o detalhe de cada mensagem individual, use o endpoint Mensagens do envio.