Plantillas y variables en la práctica

Para la mecánica completa ver Conceptos: Plantillas. Esta guía muestra casos de uso concretos.

Recordatorio de turno

{
  "name": "recordatorio-turno",
  "message": "{Hola|Buenas} {{nombre}}! Te recordamos tu turno el {{fecha}} a las {{hora}} en {{lugar}}."
}

// al programar
{
  "templateId": "...",
  "phone": "51987654321",
  "variables": { "nombre": "Ana", "fecha": "15/03", "hora": "10:00", "lugar": "Sucursal Centro" },
  "sendAt": "2026-03-14T20:00:00Z"
}

Recordatorio recurrente (cobro mensual)

{
  "name": "recordatorio-cobro",
  "message": "{{nombre}}, tu cuota vence el {{dia}}. {Cualquier consulta, respondé este mensaje|Estamos para ayudarte ante cualquier duda}."
}

{
  "templateId": "...",
  "phone": "51987654321",
  "variables": { "nombre": "Carlos", "dia": "5" },
  "recurring": true,
  "cronExpression": "0 9 1 * *",
  "timezone": "America/Lima"
}

Previsualizar antes de programar

curl -X POST https://api.tudominio.com/sessions/<sessionId>/templates/render \
  -H "x-api-key: $API_KEY" -H "Content-Type: application/json" \
  -d '{"templateId":"<templateId>","variables":{"nombre":"Ana","fecha":"15/03"}}'

Devuelve el texto final ya resuelto (spintax incluido) sin enviar nada — corré esto varias veces si querés ver las distintas variantes de spintax que puede salir.

Errores comunes

Error	Causa
400 Faltan las siguientes variables: fecha	El message tiene {{fecha}} pero no la mandaste en variables al renderizar/programar
El texto sale con {...} literal	Ese bloque no tenía ningún | adentro — no es spintax válido, se deja tal cual
Variable no se sustituye	Nombre de variable con mayúsculas/typo distinto entre {{...}} y la clave en variables (son case-sensitive)