Status do envio - Mindo API

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

GET

api

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

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.

Mostrar Propriedades de template

integer

ID interno do template.

template_name

string

Nome do template.

language

string

Idioma do template.

status

string

Status do template na Meta (APPROVED).

phone_number

object

Informações sobre o número do WhatsApp remetente.

Mostrar Propriedades de phone_number

integer

ID interno do número.

display_phone_number

string

Número formatado para exibição.

verified_name

string

Nome verificado pela Meta.

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.

Mostrar Propriedades de created_by

integer

ID do usuário.

string

E-mail do usuário.

first_name

string

Nome do usuário.

last_name

string

Sobrenome do usuário.

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

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.

Envio em massa Mensagens do envio

​Descrição

​Header de autenticação

​Parâmetros de path

​Resposta

​Status possíveis

Descrição

Header de autenticação

Parâmetros de path

Resposta

Status possíveis