Ventana de 24 horas
WhatsApp solo permite enviar texto libre a un contacto que te escribió en las últimas 24 horas. Cada mensaje del cliente reabre esa ventana.
- Dentro de la ventana: puedes responder con texto libre (
onWhatsappMessage/send-message). - Fuera de la ventana o a un contacto nuevo: necesitas una plantilla aprobada por Meta (
onConversation/send-template).
Por eso la prueba de plazbot whatsapp setup te pide escribir "hola" primero: abre la ventana y crea el contacto.
Contactos
Un contacto se crea cuando alguien le escribe a tu número. El envío de texto libre (POST /api/message) solo funciona con contactos que ya existen; si no, la API responde The contact does not exist in the database.
Las plantillas no tienen esa restricción: sirven para escribirle primero a cualquier número.
Plantillas
Una plantilla es un mensaje aprobado por Meta con variables ({{1}}, {{2}}...), por ejemplo un recordatorio de cita o una confirmación de pedido.
- Se crean y se envían a aprobación desde el panel de Plazbot (Marketing → Plantillas).
- Cada plantilla pertenece a un número conectado y se envía desde ese número.
- La aprobación de Meta puede tardar de minutos a horas.
- Solo se pueden enviar plantillas aprobadas y activas.
Tipos de conexión
| Tipo | Para qué | Cómo se conecta |
|---|---|---|
| WhatsApp API | Número nuevo o dedicado, envíos a escala y plantillas | Registro de Meta (Embedded Signup) |
| WhatsApp Business (coexistencia) | Seguir usando la app WhatsApp Business del celular y además operarla por API | Registro de Meta + escanear un QR desde la app |
| Link para tus clientes | Que tus clientes conecten su propio número en tu cuenta | Link co.plzb.link generado por API o desde el panel |
Zonas
Tu cuenta vive en una zona y la API cambia según la zona:
| Zona | Panel | API |
|---|---|---|
LA (América) | appla.plazbot.com | https://api.plazbot.com |
EU (Europa) | appeu.plazbot.com | https://apieu.plazbot.com |
El CLI la detecta al hacer plazbot login. En el SDK se indica con zone: "LA" o zone: "EU".
Credenciales
| Credencial | Dónde se usa | De dónde sale |
|---|---|---|
| Sesión del CLI | Tu computadora | plazbot login (se guarda en ~/.plazbot/config.json) |
| API key | Tu servidor o CI | Panel → Configuración → Developer |
| Workspace ID | SDK y REST | Panel → Configuración → Developer, o plazbot whoami |
Todas se pueden revocar desde Configuración → Developer.