Servidor MCP para gestionar los chats de WhatsApp Business Platform desde asistentes de IA como Meta Muse y Claude
Siga en el asistente de IA que ya usa. Conéctelo a TimelinesAI para leer sus chats de WhatsApp Business Platform, responder a clientes, enviar plantillas aprobadas y asignar y etiquetar chats para su equipo.
El servidor MCP de TimelinesAI funciona con cualquier asistente de IA que admita servidores MCP remotos con inicio de sesión OAuth. No hay software que instalar, ni servidor que administrar, ni contraseña que compartir. El asistente solo puede hacer lo que permite su rol en TimelinesAI.
Qué puede hacer el conector
- Leer chats, el historial de mensajes y el estado de los mensajes en todos sus números de WhatsApp Business Platform
- Responder con texto libre mientras la ventana de 24 horas del cliente esté abierta
- Enviar plantillas aprobadas por Meta e iniciar chats nuevos con una plantilla
- Asignar y desasignar, abrir y cerrar chats, y añadir o quitar etiquetas
- Reaccionar a mensajes y ver a los miembros de su equipo y sus plantillas
Qué necesita
- Una cuenta de TimelinesAI. Las cuentas nuevas empiezan con una prueba gratuita de 10 días, sin tarjeta de crédito.
- Al menos un número de WhatsApp Business Platform (Cloud API) conectado a su espacio de trabajo. Más información sobre WhatsApp Business API en TimelinesAI.
- Al menos una plantilla aprobada, si quiere que el asistente inicie chats nuevos o escriba a clientes fuera de la ventana de 24 horas.
Cómo configurarlo
Paso 1: Añada el conector.
En su asistente de IA, añada un conector nuevo (o un servidor MCP personalizado) y pegue
https://mcp.services.timelines.ai/mcp/waba.Paso 2: Inicie sesión con TimelinesAI.
El asistente abre la página de inicio de sesión de TimelinesAI. Inicie sesión o cree una cuenta.
Paso 3: Apruebe el acceso.
Revise los permisos en la página “Authorize timelines-mcp?” y haga clic en Authorize.
Paso 4: Haga su primera pregunta.
Pruebe con “Muestra mis números de WhatsApp Business” o “Muestra los chats que esperan respuesta”.
Datos de conexión
| Ajuste | Valor |
|---|---|
| URL del servidor MCP | https://mcp.services.timelines.ai/mcp/waba |
| Transporte | Streamable HTTP |
| Inicio de sesión | OAuth 2.1 con PKCE (S256) y registro dinámico de clientes |
| Servidor de autorización | https://mcp.services.timelines.ai |
| Ámbitos (scopes) | openidchats:readchats:writemessages:readmessages:writelabels:readlabels:writeaccounts:readworkspace:readtemplates:read |
Herramientas (18)
Las herramientas de lectura solo consultan datos. Las de escritura cambian un chat dentro de TimelinesAI. Las de escritura sensible envían algo que su cliente ve, y Meta cobra el envío de plantillas.
| Herramienta | Qué hace | Acceso |
|---|---|---|
waba_accounts | Muestra los números de WhatsApp Business Platform desde los que puede enviar | Lectura |
waba_list_chats | Muestra los chats que puede ver, con filtros (por ejemplo, por número de teléfono) | Lectura |
waba_chat_details | Muestra un chat: si la ventana de 24 horas está abierta, la persona asignada, las etiquetas y el número de envío | Lectura |
waba_chat_history | Muestra los mensajes de un chat, del más reciente al más antiguo | Lectura |
waba_message_details | Muestra un mensaje, incluido el motivo si falló | Lectura |
waba_templates | Muestra las plantillas de mensaje que puede usar | Lectura |
waba_template_details | Muestra una plantilla: su contenido, variables, estado y los números desde los que se puede enviar | Lectura |
workspace_team | Muestra a los compañeros de equipo, para poder asignarles un chat | Lectura |
waba_chat_open | Vuelve a abrir un chat cerrado | Escritura |
waba_chat_close | Cierra un chat | Escritura |
waba_chat_assign | Asigna un chat a un compañero de equipo | Escritura |
waba_chat_unassign | Quita a la persona asignada de un chat | Escritura |
waba_chat_set_label | Añade una etiqueta a un chat | Escritura |
waba_chat_remove_label | Quita una etiqueta de un chat | Escritura |
waba_chat_send_message | Envía una respuesta de texto libre en un chat existente, solo mientras la ventana de 24 horas esté abierta | Escritura sensible |
waba_chat_send_template | Envía una plantilla aprobada en un chat existente | Escritura sensibleMeta cobra las plantillas |
waba_start_chat | Inicia un chat nuevo con un número de teléfono mediante una plantilla aprobada | Escritura sensibleMeta cobra las plantillas |
waba_message_react | Añade o quita una reacción con emoji en un mensaje | Escritura sensibleEl cliente lo ve |
Cada herramienta está marcada como de solo lectura o como una que hace cambios, para que los asistentes de IA puedan pedirle confirmación antes de ejecutar una escritura.
Qué puede ver el asistente
El asistente actúa como el usuario de TimelinesAI que inició sesión, con los permisos de ese usuario. Nunca ve más de lo que ese usuario puede ver en TimelinesAI.
- Propietarios y administradores ven todos los números de WhatsApp Business Platform del espacio de trabajo y todos sus chats.
- Supervisores de equipo y compañeros de equipo ven los números cuyo equipo es el suyo, y los chats de esos números.
- Agentes ven los números que tienen asignados, y los chats de esos números.
- Colaboradores solo ven los chats que tienen asignados. Pueden responder en ellos, pero no pueden iniciar chats nuevos.
- Chats asignados: cualquier persona asignada a un chat concreto puede verlo y responder en él. Eso no le da acceso al resto de ese número.
Reglas de mensajería
- Dentro de la ventana de 24 horas (el cliente escribió en las últimas 24 horas), el asistente puede enviar respuestas de texto libre.
- Fuera de la ventana, o en un chat nuevo, solo se pueden enviar plantillas aprobadas por Meta. Una plantilla no vuelve a abrir la ventana para el texto libre.
- Las plantillas con encabezado multimedia (imagen, vídeo o documento) aún no se pueden enviar a través del conector. Use plantillas con variables de texto.
- Entrega: un envío correcto significa que Meta aceptó el mensaje. La entrega aún puede fallar después, y el asistente puede consultar el motivo.
Precios
El uso del conector está incluido en todos los planes de TimelinesAI sin coste adicional. Meta cobra los mensajes de plantilla según sus tarifas estándar de WhatsApp Business Platform, y el asistente le avisa antes de enviar uno.
Privacidad y seguridad
- El inicio de sesión usa OAuth, así que su asistente de IA nunca ve su contraseña de TimelinesAI.
- El asistente solo puede usar los datos a los que tiene acceso el usuario que inició sesión, dentro de los ámbitos indicados arriba.
- Para desconectarlo, elimine el conector en su asistente de IA.
- Consulte nuestra Política de privacidad y los Términos. Ayuda: help.timelines.ai.
Preguntas frecuentes sobre el servidor MCP de WhatsApp Business Platform
Última actualización: