Estado del envío - 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"
  }
}

Descripción

Permite consultar el estado actual y el progreso detallado de un envío masivo. Incluye contadores de mensajes enviados, entregados, leídos y fallidos, además del porcentaje de progreso.

Header de autenticación

X-API-Key

string

requerido

Tu API Key de Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parámetros de ruta

bulk_send_id

string (UUID)

requerido

ID del envío masivo obtenido al crear el envío con Enviar masivo.

Respuesta

string (UUID)

ID único del envío masivo.

status

string

Estado actual del envío. Ver tabla de estados.

template

object

Información del template utilizado.

Mostrar Propiedades de template

integer

ID interno del template.

template_name

string

Nombre del template.

language

string

Idioma del template.

status

string

Estado del template en Meta (APPROVED).

phone_number

object

Información del número de WhatsApp emisor.

Mostrar Propiedades de phone_number

integer

ID interno del número.

display_phone_number

string

Número formateado para mostrar.

verified_name

string

Nombre verificado por Meta.

total_recipients

integer

Total de destinatarios del envío.

sent_count

integer

Cantidad de mensajes enviados.

delivered_count

integer

Cantidad de mensajes entregados al destinatario.

read_count

integer

Cantidad de mensajes leídos por el destinatario.

failed_count

integer

Cantidad de mensajes fallidos.

pending_count

integer

Cantidad de mensajes pendientes de envío.

progress_percentage

float

Porcentaje de progreso del envío (0-100).

estimated_time_minutes

float

Tiempo estimado de procesamiento en minutos.

started_at

string (ISO 8601)

Fecha y hora en que comenzó el procesamiento. null si aún no inició.

completed_at

string (ISO 8601)

Fecha y hora en que finalizó el procesamiento. null si no completó.

created_at

string (ISO 8601)

Fecha y hora de creación del envío.

created_by

object

Usuario que creó el envío.

Mostrar Propiedades de created_by

integer

ID del usuario.

string

Email del usuario.

first_name

string

Nombre del usuario.

last_name

string

Apellido del usuario.

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

Estados posibles

Estado	Descripción
`QUEUED`	Envío creado y en cola de procesamiento
`PROCESSING`	Enviando mensajes activamente
`COMPLETED`	Todos los mensajes procesados exitosamente
`PARTIAL`	Procesado con algunos fallos
`FAILED`	El envío falló completamente
`CANCELLED`	Envío cancelado manualmente

Para ver el detalle de cada mensaje individual, usá el endpoint Mensajes del envío.

Enviar masivo Mensajes del envío

​Descripción

​Header de autenticación

​Parámetros de ruta

​Respuesta

​Estados posibles

Descripción

Header de autenticación

Parámetros de ruta

Respuesta

Estados posibles