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.
Permisos#
| Permiso | Para qué sirve | Tipo |
|---|---|---|
plantillas:leer | Ver las plantillas de un canal | lectura |
plantillas:escribir | Crear y eliminar plantillas | escritura |
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ámetro | Descripción |
|---|---|
canal_id | obligatorio: id del canal de WhatsApp, Messenger o Instagram |
estado | filtrar por estado (APPROVED, PENDING, REJECTED) |
nombre | filtrar por nombre exacto |
curl "https://TU_SUBDOMINIO.connecto.lat/api/v1/plantillas?canal_id=valor" \
-H "Authorization: Bearer cnx_TU_LLAVE"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();$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)#
| Campo | Descripción |
|---|---|
canal_id | obligatorio |
nombre | minúsculas, números y guion bajo |
idioma | es, en, pt_BR… (es por defecto) |
categoria | utility (por defecto), marketing o authentication (solo WhatsApp) |
cuerpo | texto con variables {{1}}, {{2}}… |
ejemplos | lista con un valor de muestra por variable |
encabezado | opcional: texto fijo (WhatsApp) |
pie | opcional: texto fijo (WhatsApp) |
botones | opcional (WhatsApp): [{"type": "QUICK_REPLY", "text": "Sí"}, {"type": "URL", "text": "Ver", "url": "https://…"}] |
{
"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"
]
}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"]}'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();$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)#
| Campo | Descripción |
|---|---|
canal_id | obligatorio |
nombre | nombre de la plantilla |
idioma | idioma de la plantilla |
{
"canal_id": 3,
"nombre": "aviso_pedido",
"idioma": "es"
}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"}'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();$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"}}.