Plantillas

Las plantillas son mensajes pre-aprobados por WhatsApp que puedes usar para iniciar conversaciones con tus clientes. Son necesarias para contactar usuarios fuera de la ventana de 24 horas.

Importante

Las plantillas no se pueden crear a través de la API. Deben gestionarse directamente desde la plataforma de Platica o desde el Administrador de WhatsApp en el Portafolio Comercial de Facebook.

Listar Plantillas

Obtiene la lista de todas las plantillas disponibles en tus workspaces.

GET https://api.platica.mx/v1/templates

Respuesta

{
  "workspaces": [
    {
      "id": "ws_123",
      "wabaId": "xxxxxxxxxx",
      "templateNamespace": "xxxx_xxx_xxx_xxxxxx",
      "name": "Soporte Técnico",
      "templates": [
        {
          "name": "bienvenida_cliente",
          "params": ["nombre", "tipo_servicio"],
          "buttons": [
            {
              "type": "text",
              "text": "Servicio Vip"
            }
          ]
        }
      ]
    }
  ]
}

Obtener una Plantilla

Obtiene el detalle completo de una plantilla específica por su nombre.

GET https://api.platica.mx/v1/templates/{templateName}

Parámetros de URL

Parámetro	Tipo	Descripción	Requerido
`templateName`	string	Nombre exacto de la plantilla a consultar	✓

Respuesta

{
  "workspaces": [
    {
      "id": "K7u9rQ2LmZx18BvC5tNd",
      "name": "Atención Premium",
      "wabaId": "155512345678901",
      "templateNamespace": "b9c4d2e1_7f3a_45b6_98cd_001122334455",
      "templates": [
        {
          "name": "recordatorio_mantenimiento_auto",
          "category": "UTILITY",
          "status": "APPROVED",
          "language": "es",
          "createdAt": "2025-07-20T10:12:34.567890123Z",
          "updatedAt": "2025-07-28T16:45:01.234567890Z",
          "content": "¡Hola {{1}}! Te recordamos tu mantenimiento.",
          "header": "Recordatorio de mantenimiento",
          "footer": "Responde CAMBIAR para reprogramar",
          "buttons": [
            {
              "type": "URL",
              "text": "Ver ubicación",
              "url": "https://example.com/taller/ubicacion"
            }
          ],
          "params": ["Carolina", "2025-08-18"],
          "api_example": {
            "name": "recordatorio_mantenimiento_auto",
            "params": ["Carolina", "2025-08-18"]
          },
          "dynamicButtonsCount": 0
        }
      ],
      "templatesCount": 1
    }
  ]
}

Campo	Descripción
`name`	Nombre único de la plantilla
`category`	Categoría: `UTILITY`, `MARKETING`, `AUTHENTICATION`
`status`	Estado de aprobación: `APPROVED`, `PENDING`, `REJECTED`
`language`	Código de idioma (ej: `es`, `en`)
`content`	Cuerpo del mensaje con variables `{{1}}`, `{{2}}`, etc.
`header`	Encabezado del mensaje (opcional)
`footer`	Pie del mensaje (opcional)
`buttons`	Array de botones interactivos
`params`	Ejemplo de valores para las variables
`api_example`	Ejemplo de uso en la API

Consejo

Usa el campo api_example como referencia para construir tus solicitudes al endpoint /v1/messages/template.

Anterior Enviar Mensaje Personalizado Siguiente Introducción