Enviar mensaje

curl -X POST https://api.mindosoftware.com/api/v1/meta-templates/send/ \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "813497231850626",
    "template_name": "welcome_message",
    "language": "es",
    "recipient_phone": "+5491112345678",
    "variables": {
      "name": "Juan Perez",
      "code": "ABC123"
    },
    "button_variables": {
      "button_0": "ABC-123"
    }
  }'

import requests

response = requests.post(
    "https://api.mindosoftware.com/api/v1/meta-templates/send/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "phone_number_id": "813497231850626",
        "template_name": "welcome_message",
        "language": "es",
        "recipient_phone": "+5491112345678",
        "variables": {
            "name": "Juan Perez",
            "code": "ABC123"
        },
        "button_variables": {
            "button_0": "ABC-123"
        }
    }
)

data = response.json()
print(f"Message ID: {data['message_id']}")
print(f"Status: {data['status']}")

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/meta-templates/send/",
  {
    method: "POST",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone_number_id: "813497231850626",
      template_name: "welcome_message",
      language: "es",
      recipient_phone: "+5491112345678",
      variables: {
        name: "Juan Perez",
        code: "ABC123"
      },
      button_variables: {
        button_0: "ABC-123"
      }
    })
  }
);

const data = await response.json();
console.log("Message ID:", data.message_id);
console.log("Status:", data.status);

{
  "success": true,
  "message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "template_name": "welcome_message",
  "recipient_phone": "+5491112345678",
  "status": "sent",
  "sent_at": "2025-11-16T21:30:00Z"
}

{
  "phone_number_id": ["This field is required."],
  "recipient_phone": ["This field is required."]
}

{
  "error": "Template 'welcome_message' no tiene estado APPROVED"
}

{
  "error": "Template 'welcome_message' (language: es) no encontrado en este business account"
}

{
  "error": "Numero de WhatsApp con ID '813497231850626' no encontrado"
}

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

POST

api

meta-templates

send

curl -X POST https://api.mindosoftware.com/api/v1/meta-templates/send/ \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "813497231850626",
    "template_name": "welcome_message",
    "language": "es",
    "recipient_phone": "+5491112345678",
    "variables": {
      "name": "Juan Perez",
      "code": "ABC123"
    },
    "button_variables": {
      "button_0": "ABC-123"
    }
  }'

import requests

response = requests.post(
    "https://api.mindosoftware.com/api/v1/meta-templates/send/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "phone_number_id": "813497231850626",
        "template_name": "welcome_message",
        "language": "es",
        "recipient_phone": "+5491112345678",
        "variables": {
            "name": "Juan Perez",
            "code": "ABC123"
        },
        "button_variables": {
            "button_0": "ABC-123"
        }
    }
)

data = response.json()
print(f"Message ID: {data['message_id']}")
print(f"Status: {data['status']}")

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/meta-templates/send/",
  {
    method: "POST",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone_number_id: "813497231850626",
      template_name: "welcome_message",
      language: "es",
      recipient_phone: "+5491112345678",
      variables: {
        name: "Juan Perez",
        code: "ABC123"
      },
      button_variables: {
        button_0: "ABC-123"
      }
    })
  }
);

const data = await response.json();
console.log("Message ID:", data.message_id);
console.log("Status:", data.status);

{
  "success": true,
  "message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "template_name": "welcome_message",
  "recipient_phone": "+5491112345678",
  "status": "sent",
  "sent_at": "2025-11-16T21:30:00Z"
}

{
  "phone_number_id": ["This field is required."],
  "recipient_phone": ["This field is required."]
}

{
  "error": "Template 'welcome_message' no tiene estado APPROVED"
}

{
  "error": "Template 'welcome_message' (language: es) no encontrado en este business account"
}

{
  "error": "Numero de WhatsApp con ID '813497231850626' no encontrado"
}

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

Descripción

Este endpoint permite enviar un template de WhatsApp a un destinatario individual. Implementa un patrón fire-and-forget: al enviar el mensaje, retorna un message_id (wamid de Meta) que podés usar para consultar el estado del mensaje. La API valida el template, resuelve las variables y envía el mensaje a través de la API de Meta de forma sincrónica.

Header de autenticación

string

requerido

Tu API Key de Mindo. Formato: mindo_xxxxxxxxxxxxxxxxxxxxxxxx

Parámetros del body

string

requerido

ID de Meta del número de WhatsApp desde el cual se enviará el mensaje. Podés obtenerlo con el endpoint Obtener cuentas de negocio.

string

requerido

Nombre del template aprobado a enviar. Debe tener estado APPROVED en Meta.

string

Idioma del template. Por defecto: "es". Ejemplos: "es", "en", "pt_BR".

string

requerido

Número de teléfono del destinatario en formato internacional (ej: "+5491112345678"). Sin espacios.

object

Variables personalizadas para el template. Las claves deben coincidir con las variables definidas en el template.

object

Variables para botones dinámicos del template. Las claves usan el formato button_0, button_1, etc., donde el número corresponde al índice del botón (comenzando en 0). Los valores son los sufijos o payloads dinámicos de cada botón.Importante: Los botones de tipo URL solo admiten 1 variable.

Respuesta (200 OK)

boolean

Indica si el mensaje fue enviado exitosamente.

string

ID del mensaje asignado por Meta (wamid). Usar para consultar el estado del mensaje.

string

Nombre del template enviado.

string

Número de teléfono del destinatario.

string

Estado inicial del mensaje. Siempre "sent" al enviarse exitosamente.

string (ISO 8601)

Fecha y hora en que se envió el mensaje.

curl -X POST https://api.mindosoftware.com/api/v1/meta-templates/send/ \
  -H "X-API-Key: mindo_xxxxxxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number_id": "813497231850626",
    "template_name": "welcome_message",
    "language": "es",
    "recipient_phone": "+5491112345678",
    "variables": {
      "name": "Juan Perez",
      "code": "ABC123"
    },
    "button_variables": {
      "button_0": "ABC-123"
    }
  }'

import requests

response = requests.post(
    "https://api.mindosoftware.com/api/v1/meta-templates/send/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "phone_number_id": "813497231850626",
        "template_name": "welcome_message",
        "language": "es",
        "recipient_phone": "+5491112345678",
        "variables": {
            "name": "Juan Perez",
            "code": "ABC123"
        },
        "button_variables": {
            "button_0": "ABC-123"
        }
    }
)

data = response.json()
print(f"Message ID: {data['message_id']}")
print(f"Status: {data['status']}")

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/meta-templates/send/",
  {
    method: "POST",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone_number_id: "813497231850626",
      template_name: "welcome_message",
      language: "es",
      recipient_phone: "+5491112345678",
      variables: {
        name: "Juan Perez",
        code: "ABC123"
      },
      button_variables: {
        button_0: "ABC-123"
      }
    })
  }
);

const data = await response.json();
console.log("Message ID:", data.message_id);
console.log("Status:", data.status);

{
  "success": true,
  "message_id": "wamid.HBgNNTQ5MTEyMzQ1Njc4FQIAERgSQjVBN0YzRjQ2NzFCNDVBNQA=",
  "template_name": "welcome_message",
  "recipient_phone": "+5491112345678",
  "status": "sent",
  "sent_at": "2025-11-16T21:30:00Z"
}

{
  "phone_number_id": ["This field is required."],
  "recipient_phone": ["This field is required."]
}

{
  "error": "Template 'welcome_message' no tiene estado APPROVED"
}

{
  "error": "Template 'welcome_message' (language: es) no encontrado en este business account"
}

{
  "error": "Numero de WhatsApp con ID '813497231850626' no encontrado"
}

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

Estados del mensaje

El campo status del mensaje puede tener los siguientes valores:

Estado	Descripción
`sent`	Mensaje enviado a Meta exitosamente
`delivered`	Mensaje entregado al dispositivo del destinatario
`read`	Mensaje leído por el destinatario
`failed`	El envío del mensaje falló

Usá el message_id retornado para consultar el estado de entrega del mensaje con Estado del mensaje.

Casos de uso

Mensaje de bienvenida a nuevo cliente

Envía un mensaje de bienvenida personalizado cuando un nuevo cliente se registra.

Python

import requests

response = requests.post(
    "https://api.mindosoftware.com/api/v1/meta-templates/send/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "phone_number_id": "813497231850626",
        "template_name": "welcome_message",
        "recipient_phone": "+5491112345678",
        "variables": {
            "name": "Juan Perez"
        }
    }
)

data = response.json()
print(f"Bienvenida enviada: {data['message_id']}")

JavaScript

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/meta-templates/send/",
  {
    method: "POST",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone_number_id: "813497231850626",
      template_name: "welcome_message",
      recipient_phone: "+5491112345678",
      variables: { name: "Juan Perez" }
    })
  }
);

const data = await response.json();
console.log("Bienvenida enviada:", data.message_id);

Código de verificación

Envía un código de verificación único al usuario.

Python

import requests
import secrets

code = secrets.token_hex(3).upper()

response = requests.post(
    "https://api.mindosoftware.com/api/v1/meta-templates/send/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "phone_number_id": "813497231850626",
        "template_name": "verification_code",
        "recipient_phone": "+5491112345678",
        "variables": {
            "name": "Juan",
            "code": code
        }
    }
)

data = response.json()
print(f"Código {code} enviado: {data['message_id']}")

JavaScript

const code = Math.random().toString(36).substring(2, 8).toUpperCase();

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/meta-templates/send/",
  {
    method: "POST",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone_number_id: "813497231850626",
      template_name: "verification_code",
      recipient_phone: "+5491112345678",
      variables: { name: "Juan", code }
    })
  }
);

const data = await response.json();
console.log(`Código ${code} enviado:`, data.message_id);

Notificación de estado de pedido

Notifica al cliente cuando su pedido cambia de estado.

Python

import requests

response = requests.post(
    "https://api.mindosoftware.com/api/v1/meta-templates/send/",
    headers={"X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx"},
    json={
        "phone_number_id": "813497231850626",
        "template_name": "order_update",
        "recipient_phone": "+5491112345678",
        "variables": {
            "order_id": "ORD-001",
            "status": "En camino"
        }
    }
)

data = response.json()
print(f"Notificación enviada: {data['message_id']}")

JavaScript

const response = await fetch(
  "https://api.mindosoftware.com/api/v1/meta-templates/send/",
  {
    method: "POST",
    headers: {
      "X-API-Key": "mindo_xxxxxxxxxxxxxxxxxxxxxxxx",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      phone_number_id: "813497231850626",
      template_name: "order_update",
      recipient_phone: "+5491112345678",
      variables: { order_id: "ORD-001", status: "En camino" }
    })
  }
);

const data = await response.json();
console.log("Notificación enviada:", data.message_id);

Comenzar

Cuentas de negocio

Información del negocio

Mensajes

Contactos

Envío masivo

Exportación cualitativa

Descripción

Header de autenticación

Parámetros del body

Respuesta (200 OK)

Estados del mensaje

Casos de uso

​Descripción

​Header de autenticación

​Parámetros del body

​Respuesta (200 OK)

​Estados del mensaje

​Casos de uso

Descripción

Header de autenticación

Parámetros del body

Respuesta (200 OK)

Estados del mensaje

Casos de uso