Ficha técnica
El detalle, para quien lo va a revisar.
Esta página es para el área de sistemas y para quien evalúa el conector antes de conectar un número. Nada de lo que sigue está simplificado.
Clientes compatibles
La IA la eliges tú.
Funciona con cualquier cliente MCP que acepte un servidor remoto Streamable HTTP. Hoy eso incluye:
- Asistentes
- Claude en web, escritorio, móvil y Code. ChatGPT en modo desarrollador. Gemini Enterprise. Mistral Le Chat. LM Studio. Copilot Studio y los complementos MCP de Microsoft 365 Copilot.
- Editores, IDE y línea de comandos
- VS Code, Cursor, Windsurf, Cline, Continue, JetBrains AI Assistant, Google Antigravity, el agente en la nube de GitHub Copilot, Gemini CLI y Codex CLI.
- Plataformas de automatización
- n8n, Make y Zapier MCP Client, este último en beta.
- Librerías y APIs
- LangChain, LlamaIndex, OpenAI Responses API y Agents SDK, la API de Gemini y la API de xAI.
- Un solo transporte
- El servidor habla solo Streamable HTTP. El transporte HTTP+SSE de 2024-11-05 quedó obsoleto: la API de Gemini ya solo acepta Streamable HTTP y Copilot Studio retiró SSE después de agosto de 2025. Sostener el transporte vigente, y solo ese, es lo que mantiene abierta la lista de arriba.
- Lo tuyo se prueba
- La conexión depende de que tu cliente admita OAuth o credenciales en encabezados. El que tú vayas a usar lo probamos juntos, contra tu propio número, durante la conexión.
Acceso
La clave va en un encabezado. Trátala como una contraseña.
- Dónde vive la clave
- Usa la dirección /mcp y envía la clave en X-MCP-Key o Authorization: Bearer. Las direcciones con la clave dentro de la ruta ya no funcionan.
- Formas de acceso
- Conecta acepta OAuth y claves en encabezados. No pongas credenciales en la dirección ni en sus parámetros; elige un cliente que admita una de estas formas de acceso.
- Protege tu clave
- Mantén la clave fuera de la URL y de cualquier chat compartido. VS Code permite configurarla en headers. Si tu cliente no permite encabezados, usa su conexión OAuth cuando esté disponible o elige otro cliente compatible.
- OAuth
- Tu asistente también puede conectarse con tu propia cuenta de Conecta: agrega https://conecta.xenth.ai/mcp, entra y elige la empresa. Lo que haga queda registrado con tu nombre.
Tratamiento de los datos
Qué pasa con lo que entra.
- Texto del cliente
- El mensaje del cliente llega a tu IA marcado como dato no confiable, nunca como instrucción.
- Ubicación de los datos
- Las conversaciones y los contactos viven en una base de datos de Cloudflare (D1) que comparten todos los clientes; cada consulta se limita al cliente por su identificador. Los archivos están en R2, bajo un prefijo con ese identificador. Las conversaciones y los contactos interesados se pueden exportar.
- Retención
- Las entregas del webhook se borran a los siete días. Las conversaciones, cuando lo pides.
- Entrada
- Los mensajes entrantes llegan por el webhook firmado de Meta. Además, una persona puede importar desde el panel el historial de un chat que ya tenga.
Herramientas
Qué expone el servidor MCP.
13ejemplos de herramientas
Estos son ejemplos de herramientas de WhatsApp. La lista disponible depende de tus permisos y de los módulos de la empresa; tu asistente consulta la lista actual al conectarse.
- whatsapp_list_conversations
- Lista las conversaciones recientes, con el contacto, el último mensaje, los no leídos y si la ventana de servicio de 24 horas sigue abierta.
- whatsapp_get_conversation
- Devuelve el hilo completo con un contacto, en ambos sentidos, con su ficha y el estado de la ventana. Pagina hacia atrás en el tiempo.
- whatsapp_search_messages
- Búsqueda de texto completo sobre todos los mensajes guardados, de todos los contactos, con los más recientes primero.
- whatsapp_get_contact
- Devuelve la ficha de un contacto: teléfono, nombre de perfil, nombre interno, etiquetas, notas, no leídos y estado de la ventana.
- whatsapp_update_contact
- Cambia el nombre interno, las notas y las etiquetas de un contacto. Solo toca los campos que le pasas.
- whatsapp_list_templates
- Lista las plantillas de la cuenta de WhatsApp Business con su nombre, idioma, categoría, estado y cuántos parámetros lleva cada una.
- whatsapp_send_message
- Envía texto libre mientras la ventana de servicio de 24 horas está abierta. Con la ventana cerrada la llamada se rechaza, y la respuesta dice cuándo cerró y qué plantillas aprobadas hay.
- whatsapp_send_template
- Envía una plantilla ya aprobada en WhatsApp Manager, con sus parámetros posicionales. Es lo único que envía esta herramienta. Rechaza a un destinatario que nunca ha escrito al número, salvo confirmación explícita, y deja la negativa en la auditoría.
- whatsapp_mark_read
- Marca la conversación como leída: manda la confirmación de lectura a Meta y pone en cero el contador local de no leídos.
- whatsapp_get_media
- Trae un adjunto por su id de medio de Meta. Una imagen que cabe en un resultado vuelve como imagen; el resto vuelve con su tipo, su tamaño y una URL temporal de descarga.
- whatsapp_save_lead
- Guarda un contacto interesado con nombre, empresa, necesidad, urgencia, notas y el id del mensaje donde aparece. Con el id de uno ya guardado edita ese registro en lugar de crear otro.
- whatsapp_list_leads
- Lista los contactos interesados guardados, del más reciente al más antiguo, con filtro por fecha y por estado.
- whatsapp_export_leads
- Exporta los contactos interesados como CSV o como tabla Markdown, del más antiguo al más reciente, en lotes que caben en un resultado.
Las dos herramientas de envío están anotadas como destructivas. Un cliente MCP que respeta esa anotación le pregunta al operador antes de ejecutarlas; la anotación es un aviso del protocolo y un cliente puede ignorarla. Lo que el conector sí garantiza es que ninguna de las dos se ejecuta si el cliente MCP no la llama.
Autoservicio
Próximamente.
Conectar tu WhatsApp sin hablar con nadie requiere que Meta apruebe a Xenth AI como Tech Provider verificado. La verificación está en curso.
Mientras tanto, la conexión la hacemos contigo en una llamada.
El triaje desde el conector lo hace la IA que ya pagas, cuando se lo pides. Los borradores de Conecta son una función distinta, desactivada de forma predeterminada: si se habilita, usa hasta tres mensajes recientes y datos acotados del negocio para proponer una respuesta que una persona revisa y aprueba antes de enviar. No consume créditos del cliente y la respuesta manual sigue disponible.