Cómo usar templates con la API de MiSender

Cuándo necesitas una template

Para iniciar una conversación fuera de las ventanas permitidas por WhatsApp debes usar una template aprobada por Meta y sincronizada en la misma cuenta MiSender.

Consulta primero las templates

curl "https://misender.com/api/v1/templates?status=APPROVED&limit=25&after=0" \
  -H "Authorization: Bearer $MISENDER_API_KEY"

Usa exactamente los valores de name y language devueltos por el endpoint. La API no crea, edita ni elimina templates.

Template con variable de cuerpo

{
  "to": "5215555555555",
  "type": "template",
  "template": {
    "name": "confirmacion_pedido",
    "language": "es_MX",
    "components": [
      {
        "type": "body",
        "parameters": [
          {"type": "text", "text": "84721"}
        ]
      }
    ]
  },
  "external_id": "pedido-84721"
}

Componentes admitidos

Los componentes permitidos son header, body y button. Los parámetros aceptados son text, currency, date_time, image, document, video y payload. Se admiten hasta 20 componentes y 20 parámetros por componente.

Encabezado con imagen

{
  "type": "header",
  "parameters": [
    {"type": "image", "image": {"link": "https://ejemplo.com/banner.jpg"}}
  ]
}

Botón con payload

{
  "type": "button",
  "sub_type": "quick_reply",
  "index": "0",
  "parameters": [
    {"type": "payload", "payload": "CONFIRMAR_84721"}
  ]
}

Errores comunes

• invalid_template: falta nombre o idioma.
• template_not_available: no existe, no está aprobada o el idioma no coincide.
• invalid_template_components: estructura o tipo de parámetro no permitido.