Agentes

Agentes es donde vive el agente de ventas de tu sitio. Es uno solo y atiende por dos canales: la burbuja del chat del sitio y tu número de WhatsApp Business.

La pestaña Agente de ventas cubre canales, encendido, autonomía, consumo y prueba. La personalidad y el conocimiento se editan en Entrenar a Colibrí; el chat del sitio tiene su pestaña para pegar el código.

Qué necesitas

Del lado de Meta, la conexión es de la cuenta del negocio:

Una cuenta de Meta Business Manager a nombre del negocio.
Una app de Meta con el producto WhatsApp, publicada en modo Live y con un token de acceso permanente de un Usuario del sistema. En modo Desarrollo, Meta no entrega los mensajes reales. El token temporal del Quickstart no sirve.
Una cuenta de WhatsApp Business (WABA) real, no la de prueba: esa no admite un número real.
Un número real, que reciba el código de verificación por SMS o llamada.

Del lado de Merez, el servidor necesita tres secretos: WHATSAPP_TOKEN, WHATSAPP_VERIFY_TOKEN y WHATSAPP_APP_SECRET. Se configuran en la plataforma, no en esta pantalla. El agente también necesita una clave de IA, del servidor o propia del sitio.

Conectar el número

En WhatsApp Manager, elige la WABA real y añade el número.
Copia el «Identificador del número de teléfono» de la ficha del número. No es el número. En la configuración de la cuenta está el «Identificador de la cuenta de WhatsApp Business».
Comprueba la plataforma del número. Si ya está en Cloud API, no se registra nada. Si sigue en la app de WhatsApp Business, conectarlo lo desconecta de esa app: es una migración, no una copia.
Completa el webhook en https://api.merez.co/api/webhooks/whatsapp. Tiene dos mitades: la app suscrita al campo messages y la WABA entregando sus mensajes a esa app. Si falta la segunda, no llega nada aunque lo demás esté en verde.
En Ajustes → Agentes → Agente de ventas → Canales → WhatsApp, pega los dos identificadores y pulsa Guardar WhatsApp. El número solo se guarda si Meta lo confirma, y no puede repetirse en otro negocio.
Pulsa Probar conexión: verás el número, el nombre verificado y la calidad de Meta. Esa prueba lee el número, no comprueba que la WABA entregue mensajes.

El ID de la cuenta también sirve para leer tus plantillas aprobadas; sin él, los mensajes que Merez inicia no se pueden verificar.

Qué hace y qué no

Lee texto, transcribe notas de voz y describe imágenes en una frase. Captura el lead, lo deja en la conversación y llena su ficha con lo que el cliente cuenta. Responde con la voz de tu marca, recomienda del catálogo y de los planes publicados, y pasa el chat a una persona cuando la venta está lista, se la piden o falta un dato que no está en el conocimiento. Sin autonomía, deja un borrador y avisa al equipo; no envía nada.

No llama por teléfono, no inicia una conversación por WhatsApp sin plantilla aprobada por Meta y no responde en un chat que una persona tomó. Tampoco borra datos: si alguien pide el borrado, abre una tarea para que el equipo lo revise.

Las instrucciones y el conocimiento son texto libre. Merez no valida su contenido: lo que el agente afirma sale de ahí y de los planes y el catálogo publicados. Si escribes un precio a mano, puede repetirlo.

Qué rompe

Cambiar el identificador del número exige pasar otra vez por Meta. Uno sin verificar responde 422 y no se guarda.
Conectar un número que sigue en la app del celular lo saca de la app.
Si la app tiene activo su saludo automático, el cliente recibe ese saludo y además la respuesta del agente.
Con el agente apagado no responde ni gasta créditos: los mensajes esperan en Conversaciones.
Sin clave de IA, no inventa una respuesta: escala el chat con el motivo.

Errores frecuentes

Síntoma	Causa	Qué hacer
«Probar conexión» falla	Identificador equivocado, o el número no está en la WABA	Revisar los dos identificadores
La prueba da bien pero no llega nada	La WABA no entrega sus mensajes a la app	Suscribir la app en la WABA
El cliente recibe dos saludos	El saludo automático de la app sigue activo	Apagarlo en el celular
El agente no contesta	Está apagado, falta el módulo o la clave de IA	Mirar el motivo en Conversaciones