Listar envios em massa

curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?status=COMPLETED&created_after=2025-11-01&page=1&page_size=10" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    params={
        "status": "COMPLETED",
        "created_after": "2025-11-01",
        "page": 1,
        "page_size": 10
    }
)

data = response.json()
print(f"Total de envios: {data['count']}")
for bulk in data["results"]:
    print(f"  {bulk['id']}: {bulk['status']} - {bulk['template']['template_name']} ({bulk['total_recipients']} destinatários)")

const params = new URLSearchParams({
  status: "COMPLETED",
  created_after: "2025-11-01",
  page: "1",
  page_size: "10"
});

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?${params}`,
  {
    headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
  }
);

const data = await response.json();
console.log(`Total de envios: ${data.count}`);
data.results.forEach(bulk => {
  console.log(`  ${bulk.id}: ${bulk.status} - ${bulk.template.template_name} (${bulk.total_recipients} destinatários)`);
});

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "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,
      "created_at": "2025-11-16T21:30:00Z",
      "completed_at": "2025-11-16T21:30:28Z"
    },
    {
      "id": "b4c3d9e0-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
      "status": "COMPLETED",
      "template": {
        "id": 46,
        "template_name": "order_confirmation",
        "language": "es",
        "status": "APPROVED"
      },
      "phone_number": {
        "id": 123,
        "display_phone_number": "+54 9 223 675-0780",
        "verified_name": "Mindo Software"
      },
      "total_recipients": 150,
      "sent_count": 150,
      "delivered_count": 142,
      "read_count": 98,
      "failed_count": 0,
      "pending_count": 0,
      "progress_percentage": 100.0,
      "created_at": "2025-11-15T14:00:00Z",
      "completed_at": "2025-11-15T14:09:30Z"
    }
  ]
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

GET

api

meta-templates

bulk-sends

curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?status=COMPLETED&created_after=2025-11-01&page=1&page_size=10" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    params={
        "status": "COMPLETED",
        "created_after": "2025-11-01",
        "page": 1,
        "page_size": 10
    }
)

data = response.json()
print(f"Total de envios: {data['count']}")
for bulk in data["results"]:
    print(f"  {bulk['id']}: {bulk['status']} - {bulk['template']['template_name']} ({bulk['total_recipients']} destinatários)")

const params = new URLSearchParams({
  status: "COMPLETED",
  created_after: "2025-11-01",
  page: "1",
  page_size: "10"
});

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?${params}`,
  {
    headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
  }
);

const data = await response.json();
console.log(`Total de envios: ${data.count}`);
data.results.forEach(bulk => {
  console.log(`  ${bulk.id}: ${bulk.status} - ${bulk.template.template_name} (${bulk.total_recipients} destinatários)`);
});

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "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,
      "created_at": "2025-11-16T21:30:00Z",
      "completed_at": "2025-11-16T21:30:28Z"
    },
    {
      "id": "b4c3d9e0-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
      "status": "COMPLETED",
      "template": {
        "id": 46,
        "template_name": "order_confirmation",
        "language": "es",
        "status": "APPROVED"
      },
      "phone_number": {
        "id": 123,
        "display_phone_number": "+54 9 223 675-0780",
        "verified_name": "Mindo Software"
      },
      "total_recipients": 150,
      "sent_count": 150,
      "delivered_count": 142,
      "read_count": 98,
      "failed_count": 0,
      "pending_count": 0,
      "progress_percentage": 100.0,
      "created_at": "2025-11-15T14:00:00Z",
      "completed_at": "2025-11-15T14:09:30Z"
    }
  ]
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Descrição

Retorna uma lista paginada de todos os envios em massa. Suporta filtros por status, template e intervalo de datas para facilitar a busca.

Header de autenticação

string

obrigatório

Sua API Key da Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parâmetros de query

string

Filtrar por status do envio. Valores possíveis: QUEUED, PROCESSING, COMPLETED, PARTIAL, FAILED, CANCELLED.

integer

Filtrar por ID do template utilizado.

string (date)

Filtrar envios criados após esta data. Formato: YYYY-MM-DD.

string (date)

Filtrar envios criados antes desta data. Formato: YYYY-MM-DD.

integer

Número da página. Padrão: 1.

integer

Resultados por página. Padrão: 20.

Resposta

integer

Total de envios em massa 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 envios em massa.

Mostrar Propriedades de cada envio

string (UUID)

ID único do envio em massa.

string

Status atual do envio.

object

Informações sobre o template utilizado.

Mostrar Propriedades de template

integer

ID interno do template.

string

Nome do template.

string

Idioma do template.

string

Status do template na Meta.

object

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

Mostrar Propriedades de phone_number

integer

ID interno do número.

string

Número formatado para exibição.

string

Nome verificado pela Meta.

integer

Total de destinatários.

integer

Mensagens enviadas.

integer

Mensagens entregues.

integer

Mensagens lidas.

integer

Mensagens com falha.

integer

Mensagens pendentes.

float

Percentual de progresso (0-100).

string (ISO 8601)

Data e hora de criação.

string (ISO 8601) | null

Data e hora de conclusão. null se não concluído.

curl -X GET "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?status=COMPLETED&created_after=2025-11-01&page=1&page_size=10" \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx"

import requests

response = requests.get(
    "https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    params={
        "status": "COMPLETED",
        "created_after": "2025-11-01",
        "page": 1,
        "page_size": 10
    }
)

data = response.json()
print(f"Total de envios: {data['count']}")
for bulk in data["results"]:
    print(f"  {bulk['id']}: {bulk['status']} - {bulk['template']['template_name']} ({bulk['total_recipients']} destinatários)")

const params = new URLSearchParams({
  status: "COMPLETED",
  created_after: "2025-11-01",
  page: "1",
  page_size: "10"
});

const response = await fetch(
  `https://api.mindosoftware.com/api/v1/meta-templates/bulk-sends/?${params}`,
  {
    headers: { "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx" }
  }
);

const data = await response.json();
console.log(`Total de envios: ${data.count}`);
data.results.forEach(bulk => {
  console.log(`  ${bulk.id}: ${bulk.status} - ${bulk.template.template_name} (${bulk.total_recipients} destinatários)`);
});

{
  "count": 2,
  "next": null,
  "previous": null,
  "results": [
    {
      "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,
      "created_at": "2025-11-16T21:30:00Z",
      "completed_at": "2025-11-16T21:30:28Z"
    },
    {
      "id": "b4c3d9e0-5f6a-7b8c-9d0e-1f2a3b4c5d6e",
      "status": "COMPLETED",
      "template": {
        "id": 46,
        "template_name": "order_confirmation",
        "language": "es",
        "status": "APPROVED"
      },
      "phone_number": {
        "id": 123,
        "display_phone_number": "+54 9 223 675-0780",
        "verified_name": "Mindo Software"
      },
      "total_recipients": 150,
      "sent_count": 150,
      "delivered_count": 142,
      "read_count": 98,
      "failed_count": 0,
      "pending_count": 0,
      "progress_percentage": 100.0,
      "created_at": "2025-11-15T14:00:00Z",
      "completed_at": "2025-11-15T14:09:30Z"
    }
  ]
}

{
  "error": "Este endpoint requiere autenticacion con API Key (header X-API-Key)"
}

Começar

Contas de negócio

Informações do negócio

Mensagens

Contatos

Envio em massa

Exportação qualitativa

Listar envios em massa

Descrição

Header de autenticação

Parâmetros de query

Resposta

​Descrição

​Header de autenticação

​Parâmetros de query

​Resposta

Descrição

Header de autenticação

Parâmetros de query

Resposta