Inicio rápido

En esta guía mandas una plantilla aprobada a un teléfono y después consultas si llegó y si la leyeron.

Necesitas: un plan Escala o Enterprise, un número de WhatsApp conectado, al menos una plantilla aprobada y una clave de API.

Guarda tu clave en una variable de entorno

Así no queda escrita en tu código.

export ELTICK_API_KEY="etk_live_…"

Busca el id de tu plantilla

GET /templates devuelve solo las plantillas aprobadas por Meta, con el nombre de cada variable.

curl https://app.eltick.com/api/v1/templates \
  -H "Authorization: Bearer $ELTICK_API_KEY"

{
  "data": [
    {
      "id": "01a0d46d-2a61-7753-b644-1f139e1e71ed",
      "name": "Pedido listo para retirar",
      "metaName": "pedido_listo_para_retirar",
      "language": "es",
      "category": "UTILITY",
      "wabaId": "264827751339679",
      "variables": [{ "name": "nombre", "label": "nombre" }]
    }
  ]
}

Anota el id y los name de las variables: los vas a usar en el paso siguiente.

Manda el mensaje

curl -X POST https://app.eltick.com/api/v1/messages \
  -H "Authorization: Bearer $ELTICK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+57 300 123 4567",
    "template": {
      "id": "01a0d46d-2a61-7753-b644-1f139e1e71ed",
      "variables": { "nombre": "Andrés" }
    }
  }'

const res = await fetch("https://app.eltick.com/api/v1/messages", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.ELTICK_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    to: "+57 300 123 4567",
    template: {
      id: "01a0d46d-2a61-7753-b644-1f139e1e71ed",
      variables: { nombre: "Andrés" },
    },
  }),
})
const message = await res.json()
if (!res.ok) throw new Error(message.error)
console.log(message.id, message.status)

import os, requests

res = requests.post(
    "https://app.eltick.com/api/v1/messages",
    headers={"Authorization": f"Bearer {os.environ['ELTICK_API_KEY']}"},
    json={
        "to": "+57 300 123 4567",
        "template": {
            "id": "01a0d46d-2a61-7753-b644-1f139e1e71ed",
            "variables": {"nombre": "Andrés"},
        },
    },
)
message = res.json()
if not res.ok:
    raise Exception(message["error"])
print(message["id"], message["status"])

<?php
$ch = curl_init("https://app.eltick.com/api/v1/messages");
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("ELTICK_API_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "to" => "+57 300 123 4567",
    "template" => [
      "id" => "01a0d46d-2a61-7753-b644-1f139e1e71ed",
      "variables" => ["nombre" => "Andrés"],
    ],
  ]),
]);
$message = json_decode(curl_exec($ch), true);
echo $message["id"] . " " . $message["status"];

Si Meta acepta el mensaje, la respuesta es 201:

{
  "id": "01a0d472-92b0-7987-ac4d-c01d37525bc5",
  "wamid": "wamid.HBgMNTczMDAxMjM0NTY3FQIAERgSN0VENTc4NDFGRDk0NEVEQkEA",
  "status": "pending",
  "conversationId": "01a0d472-90ae-7187-9bb8-9f34c8d023c1"
}

El mensaje ya aparece en el Chat de eltick, en la conversación con ese contacto. Si el teléfono no estaba en tus contactos, se crea.

Consulta si llegó

Usa el id de la respuesta:

curl https://app.eltick.com/api/v1/messages/01a0d472-92b0-7987-ac4d-c01d37525bc5 \
  -H "Authorization: Bearer $ELTICK_API_KEY"

{
  "id": "01a0d472-92b0-7987-ac4d-c01d37525bc5",
  "wamid": "wamid.HBgMNTczMDAxMjM0NTY3FQIAERgSN0VENTc4NDFGRDk0NEVEQkEA",
  "direction": "out",
  "status": "read",
  "type": "template",
  "body": "Hola Andrés, tu pedido ya está listo para retirar en Café Aurora. Te esperamos hasta las 20 h.",
  "errorCode": null,
  "errorTitle": null,
  "createdAt": "2026-09-24T17:24:33.341Z",
  "sentAt": "2026-09-24T17:24:34.000Z",
  "deliveredAt": "2026-09-24T17:24:34.000Z",
  "readAt": "2026-09-24T17:24:34.000Z"
}

status va pasando por pending → sent → delivered → read. Si no se pudo entregar queda en failed, con el motivo en errorCode y errorTitle.

En lugar de consultar cada tanto, suscríbete al webhook message.status y te avisamos cada vez que cambia el estado.

¿Y si quiero mandar texto libre?

Puedes mandar text en lugar de template, pero solo si el cliente te escribió en las últimas 24 horas. Es una regla de WhatsApp, no de eltick: fuera de esa ventana, la única forma de escribirle es con una plantilla aprobada. Más en La ventana de 24 horas.

{ "to": "+573001234567", "text": "¡Hola Andrés! Ya preparamos tu pedido 🎉" }

Si la ventana está cerrada, la API responde 409:

{
  "error": "Pasaron más de 24 horas desde el último mensaje del cliente. Para escribirle, usá una plantilla.",
  "cause": null
}

Cómo se completan las variables

Para cada variable de la plantilla, eltick usa, en este orden:

El valor que mandes en template.variables.
El dato del contacto: nombre usa el primer nombre del contacto; las demás variables buscan un atributo con el mismo nombre (por ejemplo, la variable ciudad usa el atributo ciudad).
El texto alternativo que definiste en la plantilla.
El ejemplo que cargaste al crear la plantilla.

Si no mandas una variable y el contacto no tiene ese dato, sale el ejemplo de la plantilla (por ejemplo, “Sofía”). Para mensajes transaccionales, manda siempre todas las variables.

Empieza aquí

Webhooks

Recetas

Referencia

Inicio rápido

¿Y si quiero mandar texto libre?

Cómo se completan las variables

Siguientes pasos

Recibir webhooks

Confirmación de pedidos

​¿Y si quiero mandar texto libre?

​Cómo se completan las variables

​Siguientes pasos

Recibir webhooks

Confirmación de pedidos

¿Y si quiero mandar texto libre?

Cómo se completan las variables

Siguientes pasos