Promesa de la sesión

Al salir, cada uno sabe en qué capa está.

No todos van a salir con API encendida. Sí van a saber qué les falta y en qué orden.

• Capa 1 — usan WhatsApp, pero informal
• Capa 2 — tienen Business App y desorden
• Capa 3 — tienen Portfolio / WABA / API / plantillas

Ruta de 2 horas

Primero el pulso.
Después el tubo.
Al final el checklist.

• 0:00 Apertura + QR
• 0:15 App ≠ Business ≠ API
• 0:35 Portfolio y verificación
• 0:55 Leemos sus respuestas
• 1:10 Cloud API y la ventana de 24 h
• 1:35 Plantillas: por qué las tumban
• 1:50 Tarea de la semana

Introducción · API

La app atiende a una persona.
La API atiende al sistema.

WhatsApp Business App = un celular con bandeja. Cloud API = un número que un software puede leer y responder.

• App: alguien tiene que estar pegado al teléfono
• API: el fondo puede enrutar, registrar y responder con reglas
• Sin API no hay plantilla oficial, ni webhook, ni bitácora seria

Mientras responden

Tres nombres que no son lo mismo

• WhatsApp personal — tu chat
• WhatsApp Business App — la app verde de negocio
• WhatsApp Cloud API — el canal oficial para sistemas

Bloque 1 · 20 min

El mostrador y la centralita

La app es el mostrador: una persona, una bandeja, un celular. La API es la centralita: el número entra al sistema del fondo.

• Mostrador: rápido, frágil, sin bitácora
• Centralita: más setup, más control, más reglas
• Un fondo no 'compra API'. Conecta un número a un proceso

Las 5 piezas

Portfolio → WABA → número → app Meta → webhook

• Portfolio — la empresa ante Meta
• WABA — la cuenta de WhatsApp Business
• Número — el que ven los asociados
• App de Meta — la que pide permisos
• Webhook — por dónde llegan y salen los mensajes

Dueños

Si no sabes quién es el admin, no hay API.

• Portfolio: casi siempre gerencia + un correo que nadie usa
• Número: el celular del colaborador que 'maneja WhatsApp'
• Proveedor / BSP: a veces tiene el número secuestrado
• Sistemas: a veces ni está enterado

Regla de oro

Un número.
Una WABA.
Un dueño.

El mismo número no puede vivir a la vez en la app de Business y en Cloud API como si nada. Migrar tiene costo operativo.

• Si el número está en la app, hay que sacarlo con cuidado
• Si está en un BSP, hay que ver el contrato
• Si está en personal, ni empieces por API

Bloque 2 · 20 min

Meta Business Portfolio es la cédula de la empresa.

Antes se llamaba Business Manager. Ahí viven las cuentas de WhatsApp, los anuncios, los pixeles y los permisos.

• Sin Portfolio no hay WABA seria
• Sin admin claro, nadie puede verificar ni crear plantillas
• Un correo personal de un excolaborador es una bomba

Verificación

Verificar no es un sticker.
Sube límites y baja fricción.

• Meta confirma que la empresa es quien dice ser
• Sin verificar: te trabas en plantillas, números y confianza
• Con verificar: el camino a API deja de ser un laberinto

Lo que Meta mira

Nombre, NIT, web y uso real.

• Documentos de la entidad (NIT, cámara, estatutos si piden)
• Dominio y correo que no sea Gmail de alguien
• Uso: atención a asociados, no spam de créditos
• Display name: reconocible, no un apodo interno

Errores de esta sala

Los cuatro huecos que más vemos

• El Portfolio lo creó una agencia y se fue
• El número está en un celular personal
• Tienen anuncios, pero no WABA
• Mandan campañas por la app y creen que eso es API

Cómo leerlo

Tres lecturas, no un ranking.

• Uso alto + API no = hábito sin tubo. Prioridad: Portfolio y número
• Portfolio sí + verificado no = papel. Prioridad: verificación
• API sí + plantillas no = pueden responder, no pueden iniciar

Tres grupos

A · B · C. Nadie se queda sin camino.

• A — Informal: pasar a Business App + dueño del número
• B — Business App: Portfolio, verificación, decidir número
• C — Ya con API: plantillas útiles y bitácora

Bloque 4 · 25 min

El asociado escribe.
El sistema se entera.

Cloud API no 'tiene inteligencia'. Tiene un webhook: Meta empuja el mensaje a una URL tuya.

• 1. Llega el mensaje al número
• 2. Meta lo manda a tu webhook
• 3. Tu sistema decide: humano, regla o plantilla
• 4. Respondes por la misma API

La ventana

24 horas después del último mensaje del asociado.

Dentro de la ventana puedes hablar como en un chat. Fuera de la ventana, solo plantilla aprobada.

• Él te escribe hoy: puedes resolver el caso
• Tú quieres escribirle el martes: plantilla
• Un extracto no solicitado = casi siempre plantilla

Dos tipos de mensaje

Sesión o plantilla.
No hay tercera.

• Sesión — respuesta dentro de las 24 h
• Plantilla — inicio o recontacto fuera de ventana
• Mezclarlas mal es como se quema el número

BSP o directo

Cloud API directo o un proveedor.
Las dos son API.

• Directo: tú hablas con Meta, más control, más responsabilidad
• BSP: te alquilan el tubo, a veces más rápido de encender
• Pregunta clave: ¿quién es dueño del número si terminas el contrato?

Caso de salón

El asociado escribe: «¿cómo va mi cupo?»

• App: alguien busca en el core y responde a mano
• API + humano: cae a una cola con nombre y cédula
• API + regla: si hay integración, responde saldo; si no, escala

Bloque 5 · 15 min

Una plantilla es un contrato con Meta.

Tú propones el texto. Meta decide si sale. Si cambia una coma material, vuelve a revisión.

• Nombre interno + idioma + variables
• Estado: pendiente, aprobada, rechazada
• Sin aprobada no hay inicio de conversación serio

Categorías

Utilidad. Autenticación. Marketing.

• Utilidad — extracto, cita, mora, radicado, asamblea
• Autenticación — OTP, código, 'fuiste tú'
• Marketing — cupo, convenio, campaña. La más vigilada

Por qué las tumban

Rechazo no es misterio.
Casi siempre es esto.

• Variables mal puestas o texto que parece phishing
• Promesa financiera agresiva
• Nombre del fondo irreconocible
• Pedir datos sensibles por chat

Plantillas de fondo

Empieza por lo que ya hacen a mano.

• Cita / radicado de crédito
• Recordatorio de descuento o cuota
• Asamblea o convocatoria
• Confirmación de recibido — no venta

Bloque 6 · 10 min

Checklist de esta semana.
Una sola capa por fondo.

• A — Dueño del número + WhatsApp Business App
• B — Entrar al Portfolio y listar admins
• C — Inventario: 1 plantilla útil, no 12 de marketing
• Todos — no migrar el número productivo un viernes

Cierre

API es el tubo.
El fondo es el proceso.
Meta es el portero.

Si el proceso es un desorden, la API lo hace más rápido. Si el proceso es claro, la API lo hace trazable.

• Pulso: clases.lemabot.com/ges-wp-api
• Formulario: /ges-wp-api/r
• Tablero: /ges-wp-api/tablero