Skip to main content
GET
/
templates
/
v1
/
variables
curl -X GET "https://api.whaapy.com/templates/v1/variables" \
  -H "Authorization: Bearer wha_xxxxx"
{
  "data": {
    "contact": {
      "name": "{{contact.name}}",
      "first_name": "{{contact.first_name}}",
      "last_name": "{{contact.last_name}}",
      "phone": "{{contact.phone}}",
      "email": "{{contact.email}}"
    },
    "business": {
      "name": "{{business.name}}",
      "phone": "{{business.phone}}",
      "email": "{{business.email}}",
      "address": "{{business.address}}",
      "website": "{{business.website}}"
    },
    "system": {
      "date": "{{system.date}}",
      "time": "{{system.time}}",
      "datetime": "{{system.datetime}}"
    }
  }
}
Las variables te permiten personalizar los templates con datos del contacto, negocio o sistema. Whaapy resuelve automáticamente estas variables al enviar un mensaje.

Parámetros

contactId
string
UUID del contacto para obtener valores de ejemplo resueltos
curl -X GET "https://api.whaapy.com/templates/v1/variables" \
  -H "Authorization: Bearer wha_xxxxx"
{
  "data": {
    "contact": {
      "name": "{{contact.name}}",
      "first_name": "{{contact.first_name}}",
      "last_name": "{{contact.last_name}}",
      "phone": "{{contact.phone}}",
      "email": "{{contact.email}}"
    },
    "business": {
      "name": "{{business.name}}",
      "phone": "{{business.phone}}",
      "email": "{{business.email}}",
      "address": "{{business.address}}",
      "website": "{{business.website}}"
    },
    "system": {
      "date": "{{system.date}}",
      "time": "{{system.time}}",
      "datetime": "{{system.datetime}}"
    }
  }
}

Variables del contacto

VariableDescripciónEjemplo
{{contact.name}}Nombre completoJuan Pérez
{{contact.first_name}}Primer nombreJuan
{{contact.last_name}}ApellidoPérez
{{contact.phone}}Número de teléfono+5215512345678
{{contact.email}}Emailjuan@ejemplo.com

Variables del negocio

VariableDescripciónEjemplo
{{business.name}}Nombre del negocioMi Empresa
{{business.phone}}Teléfono del negocio+5215500000000
{{business.email}}Email del negocioinfo@miempresa.com
{{business.address}}DirecciónAv. Reforma 123
{{business.website}}Sitio webhttps://miempresa.com

Variables del sistema

VariableDescripciónEjemplo
{{system.date}}Fecha actual29/01/2026
{{system.time}}Hora actual10:30
{{system.datetime}}Fecha y hora29/01/2026 10:30

Uso en templates

Puedes usar estas variables al enviar un template:
await fetch('https://api.whaapy.com/messages/v1', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer wha_xxxxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    to: '+5215512345678',
    type: 'template',
    template: {
      name: 'welcome_message',
      language: 'es_MX',
      components: [
        {
          type: 'body',
          parameters: [
            // Whaapy resolverá automáticamente el nombre del contacto
            { type: 'text', text: '{{contact.name}}' }
          ]
        }
      ]
    }
  })
});
Whaapy resuelve las variables automáticamente al enviar el mensaje. Si una variable no tiene valor (ej: el contacto no tiene email), se enviará vacía o con un valor por defecto.

Ver valores resueltos

Para previsualizar cómo se verán las variables para un contacto específico:
curl "https://api.whaapy.com/templates/v1/variables?contactId=uuid-del-contacto" \
  -H "Authorization: Bearer wha_xxxxx"
Esto te devolverá las variables con sus valores resueltos para ese contacto.