Plataforma MetaConectar tu agente a WhatsApp es como darle su propia linea telefonica — los clientes le escriben al numero y tu agente responde, igual que si le escribieran a una persona real. Tu agente puede enviar texto, imagenes, archivos, audio, botones interactivos e incluso plantillas de mensaje pre-aprobadas.
Image: Exportacion de canal WhatsApp mostrando un numero de telefono conectado
Requisitos Previos
- Un agente completado en el Panel de Control del Agente (al menos el paso de Perfil guardado)
- Una cuenta de Facebook Business (gratis — puedes crearla durante el setup)
- Un numero de telefono que no este activo actualmente en WhatsApp (personal o de negocio). Si tu numero ya esta en WhatsApp, primero tendras que desregistrarlo
Configuracion de WhatsApp
Hay dos formas de conectar WhatsApp. El Embedded Signup es lo recomendado para casi todos — es mas rapido, mas facil, y Meta lo provisiona todo automaticamente.
Opcion A — Embedded Signup (Recomendado)
Embedded Signup es el flujo de registro oficial construido por Meta. Desde un solo popup, configura todo por ti automaticamente — tu Cuenta de WhatsApp Business, tu numero de telefono, el pase de acceso que Nirvai necesita y el aviso automatico que WhatsApp le envia a Nirvai cuando llega un mensaje — todo sin que toques los ajustes de desarrollador de Meta.
Lo que Meta configura automaticamente:
- Una Cuenta de WhatsApp Business (WABA — la cuenta de WhatsApp de tu negocio con Meta) vinculada a tu Facebook Business
- Un numero de telefono registrado contra tu WABA — uno existente o uno nuevo
- Un system user (una cuenta automatica que Meta usa para actuar en tu nombre) con los permisos correctos en tu Facebook Business
- Un token de acceso permanente — un pase de acceso seguro limitado a WhatsApp
- La suscripcion del webhook — el aviso automatico que WhatsApp le envia a Nirvai en el momento en que un cliente te escribe
Nunca tienes que copiar y pegar contrasenas privadas ni generar pases de acceso manualmente.
Pasos:
- Abre tu agente en el Panel de Control del Agente y haz clic en el nodo Canales
- Selecciona WhatsApp en la seccion Plataforma Meta
- Elige Business App
- Haz clic en Start Setup — se abre un popup de Facebook Login
- Inicia sesion con la cuenta de Facebook que es duena (o sera duena) del Business
- Sigue el onboarding de WhatsApp Business en pantalla:
- Selecciona un Business existente o crea uno nuevo
- Selecciona o crea una Cuenta de WhatsApp Business
- Elige un numero de telefono existente, portea uno o compra uno nuevo
- Verifica el numero por SMS o llamada
- Confirma los permisos — Meta te regresa a Nirvai
- Tu numero de WhatsApp aparece como Conectado en la tarjeta de exportacion
Image: Flujo de Embedded Signup de WhatsApp Business con popup de Facebook Login
Si ya tienes una Credencial de Plataforma Meta para WhatsApp, puedes seleccionarla durante el setup en vez de pasar por Facebook Login otra vez. La misma credencial puede alimentar varios canales Meta (WhatsApp + Instagram + Messenger) sin re-autenticarte.
El Embedded Signup usa tu Facebook Business real — la misma cuenta donde tu (o tu cliente) ya gestionan Paginas, cuentas de anuncios y otros activos de Meta. Si no tienes uno, Meta te ayudara a crearlo durante el popup; toma un par de minutos.
Opcion B — Configuracion Manual (SIM Integration)
Elige esta opcion solo si ya tienes un setup de WhatsApp Business API en otra parte y necesitas conectar Nirvai a el. El flujo Manual te da un stepper guiado para ingresar las credenciales tu mismo.
- Abre tu agente en el Panel de Control del Agente y haz clic en el nodo Canales
- Selecciona WhatsApp → SIM Integration
- Sigue los pasos guiados:
- Crea una Meta App (si no tienes una)
- Agrega el producto WhatsApp a tu app
- Registra tu numero de telefono
- Crea un system user y genera un token de acceso
- Verifica tu numero de telefono
- Configura la URL del webhook proporcionada por Nirvai
- Ingresa tus credenciales y guarda
Image: Stepper de configuracion manual de WhatsApp
La configuracion manual involucra tu Consola de Desarrolladores de Meta y varios pasos de copy-paste de credenciales. Usa Embedded Signup a menos que tengas una razon especifica para no hacerlo — es significativamente mas rapido y menos propenso a errores.
Tipos de Mensaje
Una vez conectado tu agente, puede enviar y recibir varios tipos de mensajes. Algunos son solo de entrada (el agente los lee), algunos son solo de salida (el agente los envia), y la mayoria van en ambas direcciones.
| Tipo | Direccion | Descripcion |
|---|---|---|
| Texto | Ambas | Mensajes de texto plano, con emoji y markdown basico de WhatsApp (*negrita*, _cursiva_) |
| Imagenes | Ambas | Fotos, capturas de pantalla, graficos generados. Entra via vision, sale desde archivos del agente |
| Documentos | Ambas | PDFs, hojas de calculo, documentos Word y otros archivos adjuntos |
| Audio | Ambas | Notas de voz. El audio entrante se transcribe automaticamente; el saliente se envia como nota de voz |
| Video | Entrante | Mensajes de video cortos — el agente extrae frames y los analiza |
| Botones Interactivos | Saliente | Botones de respuesta rapida o de CTA anclados a un mensaje |
| Plantillas | Saliente | Plantillas de mensaje pre-aprobadas por Meta (ver mas abajo) |
Puedes activar o desactivar que tipos de mensajes salientes estan habilitados en tu configuracion de exportacion. El texto siempre esta habilitado. Desactiva los tipos que no quieras que el agente use — por ejemplo, si nunca quieres que tu agente envie imagenes, desactiva el toggle de Imagenes.
Image: Configuracion de tipos de mensaje de la exportacion de WhatsApp
La entrada siempre esta activa. Los clientes pueden enviar cualquier tipo de medio en cualquier momento — el agente lo procesara (transcribira audio, analizara imagenes, leera documentos). Los toggles solo controlan lo que el agente puede enviar de vuelta.
Plantillas de Mensaje de WhatsApp
WhatsApp requiere que los negocios usen plantillas pre-aprobadas para iniciar conversaciones con usuarios (mensajes salientes fuera de la ventana de 24 horas de atencion al cliente). Las plantillas son revisadas por Meta y deben seguir sus politicas de contenido.
Que son las Plantillas?
Las plantillas son mensajes estructurados que disenas con anticipacion. Pueden incluir:
- Header — Texto, imagen, video o documento
- Body — El texto principal del mensaje, con placeholders opcionales para personalizacion (ej.,
{{1}}para el nombre del cliente) - Footer — Texto pequeno debajo del body
- Botones — Respuesta Rapida, URL o Numero de Telefono
Viendo y Enviando Plantillas
- Abre una conversacion de WhatsApp en la Vista de Chat
- Haz clic en el boton Plantillas
- Navega tus plantillas aprobadas — puedes filtrar por:
- Estado: Aprobada, Pendiente, Rechazada
- Idioma: Ingles, Espanol, etc.
- Categoria: Marketing, Utilidad, Autenticacion
- Selecciona una plantilla y completa los parametros requeridos
- Haz clic en Enviar
Image: Selector de plantillas de WhatsApp mostrando plantillas aprobadas con campos de parametros
Categorias de Plantilla
| Categoria | Proposito | Ejemplo |
|---|---|---|
| Marketing | Promociones, ofertas, anuncios | "Hola {{1}}, mira nuestra nueva coleccion!" |
| Utilidad | Actualizaciones de pedido, recordatorios, confirmaciones | "Tu pedido {{1}} ha sido enviado" |
| Autenticacion | Codigos de verificacion | "Tu codigo es {{1}}. Valido por 5 minutos." |
Las plantillas deben ser aprobadas por Meta antes de poder usarlas. La aprobacion normalmente toma unos minutos pero puede tardar hasta 24 horas.
Vista de Chat e Intervencion Humana
La Vista de Chat de WhatsApp te permite ver todas las conversaciones entrantes e intervenir cuando necesites tomar el control del agente.
Image: Vista de Chat de WhatsApp mostrando conversaciones y el interruptor del agente
Viendo Conversaciones
- Abre tu agente en el Panel de Control del Agente
- Selecciona la exportacion de WhatsApp
- Veras todas las conversaciones listadas con los ultimos mensajes
Pausar el Agente en una Conversacion (Auto / Manual)
Cada conversacion tiene su propio interruptor. Es por conversacion — cambiar una conversacion a Manual no afecta a las demas.
| Modo | Que Sucede |
|---|---|
| Auto (verde) | El agente responde automaticamente a los mensajes entrantes en esa conversacion |
| Manual (gris) | El agente se pausa en esa conversacion — tu respondes manualmente como humano |
Cuando cambias una conversacion a Manual:
- El agente deja de responder solo en esa conversacion
- Puedes escribir y enviar mensajes directamente al usuario desde la Vista de Chat
- Las demas conversaciones siguen funcionando con el agente habilitado
- Opcionalmente puedes definir un motivo para la pausa (ej., "Transferiendo al equipo de soporte")
Cambia de vuelta a Auto cuando estes listo para que el agente retome. El agente vera el historial completo — incluyendo los mensajes que enviaste manualmente — para que pueda continuar la conversacion sin perder el hilo.
Usa el modo Manual para situaciones complejas que necesitan un toque humano — disputas de facturacion, temas sensibles o cualquier cosa que el agente no pueda manejar. El usuario no notara la diferencia; los mensajes salen del mismo numero de WhatsApp.
Pausar el Canal Completo (Desactivar Sin Desconectar)
A veces necesitas que el agente deje de responder en todas las conversaciones sin desconectar WhatsApp por completo. Por ejemplo: vacaciones, un problema temporal con tu base de conocimiento o mientras estas lanzando una nueva version del agente.
La desactivacion del canal te permite pausar al agente en todo el canal de WhatsApp — manteniendo todas las conversaciones y los mensajes entrantes guardados para cuando estes listo para volver.
Image: Desactivar el canal de WhatsApp del agente — preview del interruptor y su impacto
Que Sucede al Desactivar
| Comportamiento | Estado |
|---|---|
| El agente deja de responder | ✓ Se detiene en todas las conversaciones de WhatsApp inmediatamente |
| Los mensajes entrantes se siguen guardando | ✓ Todos los mensajes, archivos, audio y medios se siguen almacenando |
| Las conversaciones siguen visibles | ✓ Puedes seguir navegando la lista completa de conversaciones y el historial en la Vista de Chat |
| Consumo de creditos | ✓ Cero — el agente nunca se invoca mientras esta desactivado |
| El numero de telefono sigue conectado | ✓ El setup de WhatsApp Business se preserva; no tienes que re-autenticarte |
| Aun puedes enviar mensajes manualmente | ✓ Responde a mano desde la Vista de Chat en cualquier conversacion |
Como Desactivar
- Abre tu agente en el Panel de Control del Agente y selecciona la exportacion de WhatsApp
- Apaga el interruptor de Activo en la tarjeta de exportacion
- Aparece un panel de confirmacion explicando el impacto — confirma para aplicar
- La tarjeta se atenua para indicar que el canal esta pausado
Image: Interruptor de desactivacion del canal de WhatsApp y panel de confirmacion
Para reactivar, vuelve a encender el interruptor. El agente retoma justo donde quedo, con el historial completo de conversaciones intacto — incluyendo cualquier mensaje recibido mientras el canal estuvo pausado.
Desactivacion del Canal vs Modo Manual
Estos dos controles resuelven problemas distintos. Usa el correcto para tu situacion:
| Modo Manual (por conversacion) | Desactivacion del Canal (todo el canal) | |
|---|---|---|
| Alcance | Una conversacion especifica | Todas las conversaciones del canal |
| Ideal para | Un cliente especifico que necesita ayuda humana | Vacaciones, mantenimiento, problemas del agente |
| Otras conversaciones | Continuan con el agente | Tambien pausadas — ninguna recibe respuesta |
| Respuestas manuales | Si, desde la Vista de Chat | Si, desde la Vista de Chat |
| Donde activarlo | Dentro de la vista de la conversacion | En la tarjeta de exportacion de WhatsApp |
Gestion de tu Exportacion
Editando la Configuracion
Haz clic en el boton de editar en tu exportacion de WhatsApp para:
- Activar/desactivar que tipos de mensajes salientes estan habilitados
- Ver tu numero de telefono conectado y el ID de WABA
- Reconfigurar credenciales si es necesario
Eliminando la Exportacion
Para desconectar WhatsApp de este agente por completo:
- Abre el panel de Canales
- Haz clic en el boton de eliminar en la exportacion de WhatsApp
- Confirma la eliminacion
Tu cuenta de WhatsApp Business sigue intacta en Meta — solo se elimina la conexion con este agente. El numero de telefono sigue registrado a tu WABA y puede ser reconectado mas adelante (al mismo agente o a uno distinto).
Si solo necesitas una pausa temporal, usa la desactivacion del canal (arriba) en vez de eliminar la exportacion. Desactivar conserva tu historial de conversaciones, mientras que eliminar la exportacion desconecta todo.
Solucion de Problemas
| Problema | Solucion |
|---|---|
| Los mensajes no llegan | Verifica que el canal este activo (interruptor en la tarjeta de exportacion). Si usaste el setup Manual, verifica que la URL del webhook este configurada en los ajustes de tu Meta App |
| El agente no responde en una conversacion | Verifica que el interruptor de la conversacion este en Auto en la Vista de Chat |
| El agente no responde en ninguna conversacion | Verifica que el canal en si este activo — el interruptor de la tarjeta de exportacion podria estar apagado |
| Plantilla rechazada | Revisa las politicas de contenido de Meta y vuelve a enviarla con contenido conforme |
| Numero de telefono ya registrado | El numero no debe estar activo en otra cuenta de WhatsApp. Desregistralo primero |
| Popup de Facebook Login bloqueado | Permite popups de Nirvai en la configuracion de tu navegador |
| El popup de Embedded Signup no regresa | Cierra el popup e intenta de nuevo. Si cambiaste de cuenta de Facebook a mitad del flujo, cierra sesion en todas las cuentas de Facebook y empieza de nuevo |
Que sigue
Para entender las reglas de Meta detras de escena — la ventana de respuesta de 24 horas, los limites de mensajeria, la aprobacion de plantillas y los precios — lee la Guia de la Plataforma WhatsApp.