Ir al contenido
Documentación de Connecto
connecto.lat
API para desarrolladoresReferencia

Plantillas de mensaje (ver, crear y eliminar)

Un sistema externo ve, crea y elimina las plantillas de un canal de WhatsApp, Messenger o Instagram. Se crean en Meta y quedan pendientes hasta que las apruebe. Nace apagada y sus permisos se dan de forma explícita.

Esta API nace apagada: actívala en Configuración → APIs antes de usarla.

Permisos#

PermisoPara qué sirveTipo
plantillas:leerVer las plantillas de un canallectura
plantillas:escribirCrear y eliminar plantillasescritura

Endpoints#

GET /plantillas#

Lista las plantillas del canal con su estado en Meta (APPROVED, PENDING, REJECTED…).

Permiso: plantillas:leer · lectura

Parámetros de la consulta#

ParámetroDescripción
canal_idobligatorio: id del canal de WhatsApp, Messenger o Instagram
estadofiltrar por estado (APPROVED, PENDING, REJECTED)
nombrefiltrar por nombre exacto
Ejemplo en curl
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas?canal_id=valor" \
  -H "Authorization: Bearer cnx_TU_LLAVE"
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas?canal_id=valor", {
  method: "GET",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY }
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas?canal_id=valor");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY")],
]);
$datos = json_decode(curl_exec($ch), true);

POST /plantillas#

Crea una plantilla en Meta. El cuerpo lleva de 1 a 5 variables {{1}}…{{5}} (en orden, sin empezar ni terminar con una) y un ejemplo por variable. En WhatsApp admite encabezado y pie de texto y botones (respuesta rápida, enlace fijo o teléfono).

Permiso: plantillas:escribir · escritura

Cuerpo (JSON)#

CampoDescripción
canal_idobligatorio
nombreminúsculas, números y guion bajo
idiomaes, en, pt_BR… (es por defecto)
categoriautility (por defecto), marketing o authentication (solo WhatsApp)
cuerpotexto con variables {{1}}, {{2}}…
ejemploslista con un valor de muestra por variable
encabezadoopcional: texto fijo (WhatsApp)
pieopcional: texto fijo (WhatsApp)
botonesopcional (WhatsApp): [{"type": "QUICK_REPLY", "text": "Sí"}, {"type": "URL", "text": "Ver", "url": "https://…"}]
Ejemplo de cuerpo
{
  "canal_id": 3,
  "nombre": "aviso_pedido",
  "idioma": "es",
  "categoria": "utility",
  "cuerpo": "Hola {{1}}, recibimos tu pedido {{2}}. Te avisamos cuando salga.",
  "ejemplos": [
    "Ana",
    "PED-123"
  ]
}
Ejemplo en curl
curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"canal_id":3,"nombre":"aviso_pedido","idioma":"es","categoria":"utility","cuerpo":"Hola {{1}}, recibimos tu pedido {{2}}. Te avisamos cuando salga.","ejemplos":["Ana","PED-123"]}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "canal_id": 3,
    "nombre": "aviso_pedido",
    "idioma": "es",
    "categoria": "utility",
    "cuerpo": "Hola {{1}}, recibimos tu pedido {{2}}. Te avisamos cuando salga.",
    "ejemplos": [
        "Ana",
        "PED-123"
    ]
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'canal_id' => 3,
  'nombre' => 'aviso_pedido',
  'idioma' => 'es',
  'categoria' => 'utility',
  'cuerpo' => 'Hola {{1}}, recibimos tu pedido {{2}}. Te avisamos cuando salga.',
  'ejemplos' => 
  array (
    0 => 'Ana',
    1 => 'PED-123',
  ),
)),
]);
$datos = json_decode(curl_exec($ch), true);

POST /plantillas/eliminar#

Elimina una plantilla (un idioma). No se puede si hay una difusión programada o en curso que la usa.

Permiso: plantillas:escribir · escritura

Cuerpo (JSON)#

CampoDescripción
canal_idobligatorio
nombrenombre de la plantilla
idiomaidioma de la plantilla
Ejemplo de cuerpo
{
  "canal_id": 3,
  "nombre": "aviso_pedido",
  "idioma": "es"
}
Ejemplo en curl
curl -X POST "https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas/eliminar" \
  -H "Authorization: Bearer cnx_TU_LLAVE" \
  -H "Content-Type: application/json" \
  -d '{"canal_id":3,"nombre":"aviso_pedido","idioma":"es"}'
Ejemplo en javascript
const respuesta = await fetch("https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas/eliminar", {
  method: "POST",
  headers: { "Authorization": "Bearer " + process.env.CONNECTO_API_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
    "canal_id": 3,
    "nombre": "aviso_pedido",
    "idioma": "es"
})
});
const datos = await respuesta.json();
Ejemplo en php
$ch = curl_init("https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas/eliminar");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("CONNECTO_API_KEY"), "Content-Type: application/json"],
  CURLOPT_POSTFIELDS => json_encode(array (
  'canal_id' => 3,
  'nombre' => 'aviso_pedido',
  'idioma' => 'es',
)),
]);
$datos = json_decode(curl_exec($ch), true);

Respuesta#

listar: {"datos": [{"nombre", "idioma", "categoria", "estado", "motivo_rechazo", "cuerpo", "variables", "encabezado", "pie", "botones"}], "total"}. crear: {"datos": {"nombre", "idioma", "categoria", "estado", "id_meta"}}.

¿Te fue útil esta página?
Última actualización: 14/11/2026