WeSpeak MCP Connection

WeSpeak MCP es el conector oficial de WeSpeak para Claude (claude.ai) y ChatGPT en su versión web (chatgpt.com): suma a tu IA las mismas herramientas del asistente que ya usas en el panel, para que operes tu cuenta conversando con tu propia IA — buscar conversaciones, mover leads, consultar métricas, editar el conocimiento de tu asistente o pausarlo — sin entrar al panel.

MCP (Model Context Protocol) es el protocolo estándar con el que las IAs se conectan a herramientas externas. Como las herramientas de WeSpeak conviven con las demás que tengas conectadas, puedes pedirle a tu IA cosas que el panel no hace: por ejemplo, un reporte que cruce tus métricas de WeSpeak con tus planillas.

En este artículo

• Qué necesitas
• Cómo conectarlo
• Qué puede hacer cada rol
• Situaciones de uso: qué puedes pedirle
• Qué puede modificar (y qué no)
• Seguridad y privacidad
• Si manejas varias propiedades
• Solución de problemas
• Límites actuales
• Preguntas frecuentes

Qué necesitas

1. La función activada en tu cuenta — lo gestiona tu asesor de WeSpeak. Al activarse, tus datos de conexión aparecen en la pantalla Configuración del panel.
2. Una cuenta de Claude o ChatGPT web que permita agregar conectores personalizados. En una cuenta de equipo, puede ser necesario que su administrador habilite esta opción.
3. Tu usuario de WeSpeak de siempre. No hay claves nuevas ni API keys: el acceso se autoriza iniciando sesión, y cada acción respeta el rol de tu usuario.

Cómo conectarlo

En el panel de WeSpeak, entra a Configuración y busca WeSpeak MCP Connection. Allí tienes los datos de tu cuenta listos para copiar: el nombre sugerido del conector, la URL de tu cuenta y el Client ID, con una pestaña de instrucciones para cada aplicación.

La URL termina en ?username= seguido del identificador de la cuenta de WeSpeak, no del correo de la persona. Cópiala completa: no la recortes ni uses la de otra cuenta. El Client ID es público y es el mismo para Claude y ChatGPT; Client Secret se deja vacío.

Si ves el botón Copiar prompt de conexión, puedes usarlo y pegar el texto en ChatGPT o Claude: ya incluye los datos de esta cuenta. La IA te ayudará a configurar la conexión o te guiará paso a paso, según las herramientas que tenga disponibles. Tú completas el inicio de sesión y la autorización. También puedes seguir los pasos manuales de abajo.

Conectar desde Claude

1. En un plan personal de claude.ai, ve a Customize → Connectors → Add → Add custom connector. En Team o Enterprise, una persona propietaria de la organización lo agrega desde Organization settings → Connectors → Add → Custom (elige Web si lo solicita); después, los miembros entran a Customize → Connectors para conectarlo. Si WeSpeak ya aparece en la lista, omite los pasos de creación y conéctalo. Estos nombres corresponden a la interfaz de Claude en inglés.
2. Introduce el nombre sugerido en Name y pega la URL exacta del servidor que copiaste de WeSpeak en MCP server URL.
3. El diálogo varía según la organización. En el diálogo de dos pasos, pulsa Continue, elige Sign in now en Authentication y luego Use your own OAuth client en OAuth client. Pega el Client ID de WeSpeak en OAuth client ID y deja OAuth client secret (optional) vacío. En el diálogo de una sola pantalla, abre Advanced settings para introducir el Client ID y dejar el secret vacío. No elijas registro automático: esta conexión usa el cliente OAuth indicado por WeSpeak.
4. Pulsa Add para terminar de agregar el conector y Connect si lo solicita. Inicia sesión con tu usuario de WeSpeak y autoriza el acceso cuando Claude lo indique. Espera a que termine la autorización y Claude te redirija de vuelta.
5. Abre una conversación nueva, selecciona + → Connectors y habilita WeSpeak.

El video de Configuración sirve de referencia para conectar Claude. Los menús y el diálogo pueden variar respecto al video; sigue los pasos anteriores y la guía de conectores personalizados de Claude.

Conectar desde ChatGPT web

1. Abre ChatGPT Plugins, pulsa + y elige Add custom MCP server. Si no aparece esta opción, comprueba si tu cuenta y espacio de trabajo permiten plugins MCP personalizados.
2. Introduce el nombre sugerido en Name y, si quieres, una descripción en Description. En Connection, mantén seleccionada la opción Server URL y pega la URL exacta del servidor de tu cuenta, incluido ?username=....
3. En Authentication, selecciona OAuth y abre Advanced OAuth settings. Dentro de Client registration, elige User-Defined OAuth Client en Registration method. Pega el Client ID de WeSpeak en OAuth client ID, deja OAuth client secret vacío y mantén Token endpoint auth method en none.
4. Revisa el aviso de conexión, marca I understand and want to continue y pulsa Create as a plugin. Completa el inicio de sesión de WeSpeak con un usuario de la cuenta que estás conectando y autoriza el acceso cuando ChatGPT lo solicite.
5. Instala el plugin creado y selecciónalo en una conversación nueva mediante @.

Estos nombres corresponden a la interfaz de ChatGPT en inglés; las traducciones y la disponibilidad pueden variar según la cuenta o el espacio de trabajo. Consulta la guía de OpenAI para conectar un servidor MCP personalizado.

Si cualquiera de las aplicaciones muestra una URL de retorno (callback), no tienes que registrarla manualmente: WeSpeak ya admite los callbacks de Claude y ChatGPT web.

Comprobar la conexión

Comprueba que aparecen las herramientas de WeSpeak en una conversación nueva. Haz una consulta de solo lectura, por ejemplo:

¿A qué cuenta de WeSpeak corresponde esta conexión? Lista las herramientas disponibles para mí. Lee la configuración del asistente si mi rol lo permite; de lo contrario, busca la guía de ayuda sobre conversaciones. No modifiques datos ni envíes mensajes.

Las herramientas disponibles dependen de tu rol. Confirma que el conector identifica la cuenta elegida antes de usarlo para hacer cambios. Si tienes varias cuentas conectadas, indica cuál quieres consultar.

ℹ️ Cada persona del equipo conecta su propio usuario de WeSpeak desde su cuenta de Claude o ChatGPT. No compartan usuarios: las herramientas conservan los permisos de cada persona.

Qué puede hacer cada rol

Son las mismas reglas del panel: cada usuario ve solo las herramientas que su rol permite, y los roles superiores suman las de los inferiores.

ℹ️ En la lista de herramientas del conector vas a ver nombres técnicos en inglés (searchConversations, knowledgeAssistant, testAssistant…). No hace falta memorizarlos: tu IA elige la herramienta según lo que le pidas.

Situaciones de uso: qué puedes pedirle

Tu IA no solo ejecuta una herramienta por vez: encadena varias en un mismo pedido (buscar → leer → resumir → actuar) y redacta el resultado en el formato que le pidas — una lista, una tabla, un informe. Estos son ejemplos reales de lo que puedes pedirle, agrupados por tarea; entre paréntesis, el rol mínimo que necesitas.

Operación diaria de conversaciones (Operador · Supervisor para actuar)

Busca por texto, estado (abiertas/cerradas), canal (WhatsApp, Instagram, Facebook), agente asignado y rango de fechas, y lee el hilo completo de una conversación — incluidas las transcripciones de audios que ya se hayan generado en el panel.

• "Muéstrame las conversaciones abiertas de hoy que todavía no tienen agente asignado."
• "Busca conversaciones de esta semana donde pregunten por late check-out o early check-in."
• "Resúmeme la conversación con +54 9 11 … y dime qué quedó pendiente de responder."
• "¿Qué conversaciones de Instagram del fin de semana siguen abiertas?"
• Con rol Supervisor, además actúa: "Asígnale a Lucía las abiertas de ayer que hablan de grupos", "Cierra las de la semana pasada que ya tienen reserva confirmada", "Pospón esta conversación hasta el lunes a las 9".

💡 Para acciones en lote (asignar o cerrar varias), pídele primero la lista y después la acción: así revisas exactamente qué va a tocar.

Leads y embudo de ventas (Supervisor)

Lista los leads con filtros por texto, estado, días sin actividad y etapa del embudo, y los mueve de etapa (ganado, perdido con motivo, o a una etapa concreta).

• "Lístame los leads que llevan más de 5 días sin actividad."
• "¿Cuántos leads tenemos hoy en 'Cotizado' y quiénes son?"
• "Marca como perdido el lead de García con motivo 'eligió otro hotel'."
• "Arma una tabla con los leads abiertos, su etapa y su última actividad para pasársela al equipo de ventas."
• "Dame los leads estancados, lee sus conversaciones y dime a cuáles conviene retomar primero y con qué mensaje." — tu IA lee cada hilo, prioriza y te propone el texto; el envío lo haces tú desde el panel.

Reportes y estadísticas (Supervisor)

Las métricas que tu IA puede consultar hoy son dos: volumen (mensajes y conversaciones en un período, en días — la última semana, los últimos 30 días…) y embudo (cuántos leads hay en cada etapa y cuántos se ganaron o perdieron en el período, con el nombre de cada etapa). El resto lo arma contando y cruzando los resultados de las búsquedas de conversaciones y leads. Algunos reportes que puedes pedirle tal cual:

• Reporte semanal de actividad: "Arma el resumen de la semana: conversaciones y mensajes de los últimos 7 días, comparados con la semana anterior, y las 5 consultas más repetidas."
• Reporte de embudo: "¿Cómo viene la conversión del embudo en los últimos 30 días? Cuántos leads entraron, en qué etapa está cada uno y cuántos cerramos."
• Reparto por canal y por agente: "De las conversaciones de esta semana, ¿cuántas entraron por cada canal y cuántas tiene asignadas cada agente?"
• Backlog del equipo: "¿Cuántas conversaciones abiertas hay por agente y cuáles llevan más días sin actualizarse?"
• Temas recurrentes y huecos de conocimiento: "Lee las conversaciones de los últimos 3 días y dime qué preguntas se repiten y en cuáles el asistente derivó a un asesor." — ideal para decidir qué agregar al conocimiento.
• Seguimientos automáticos: "¿A cuántas de las conversaciones de la semana se les envió el mensaje de seguimiento automático?"
• Leads estancados por etapa: "Cuántos leads llevan más de 7 días sin actividad en cada etapa del embudo."
• Formato y exportación: "Pasa ese reporte a una tabla que pueda pegar en una planilla", "Ármalo como un informe corto para enviar por mail a la gerencia". Si tienes otras herramientas conectadas en tu IA (planillas, documentos, mensajería), puedes pedirle que lo guarde o comparta ahí directamente.

ℹ️ Las métricas actuales no incluyen tiempos de respuesta ni el reparto entre respuestas del asistente y humanas. Los reportes que se arman listando conversaciones vienen paginados: para volúmenes grandes, acota el período (una semana, un mes) para que sea preciso.

Reservas (Operador · requiere WeSpeak Payments)

• "Muéstrame las últimas reservas y su estado."
• "Busca la reserva ABC123 y dime qué se pagó y qué falta."
• "¿El huésped de la reserva ABC123 escribió algo después de reservar?" — cruza la reserva con su conversación.

Conocimiento del asistente (Administrador)

Lee el conocimiento por campo o por búsqueda semántica, lo edita con validación, respaldo y verificación, y puede deshacer. Es la forma de mantener actualizado lo que el asistente virtual responde.

• Auditar: "¿Qué dice hoy el conocimiento sobre mascotas, estacionamiento y horario de check-in?", "Busca en el conocimiento todo lo relacionado con cancelaciones y dime si hay contradicciones."
• Actualizar datos: "Cambia el horario del desayuno a 7:30–10:30", "Actualiza el link de reservas", "Agrega las instrucciones para pagar por transferencia."
• Reglas de comportamiento: "Que no prometa avisar cuando se verifique un pago", "Que antes de cotizar pregunte siempre las fechas y la cantidad de personas."
• Cuándo derivar a un humano: "Cuando pregunten por eventos o bodas, que el asistente derive a un asesor."
• Historial y deshacer: "¿Qué cambios se hicieron en el conocimiento esta semana y quién los hizo?", "Deshaz el último cambio."
• Varios complejos: aclara cuál ("…solo en el complejo de la playa") o pídele que lo aplique en todos.

ℹ️ Las promociones y descuentos, las descripciones y fotos de habitaciones, y los horarios de atención no se editan desde aquí: tu IA te va a indicar dónde se configura cada cosa (ver la sección siguiente).

Control de calidad del asistente (Administrador)

Con los mensajes de prueba, tu IA puede hacerse pasar por un huésped, incluso en varios turnos, y comparar lo que responde el asistente con lo que debería responder.

• "Pregúntale al asistente si aceptan mascotas y, en el mismo chat, el precio para 2 personas del 12 al 15 de octubre. Dime si respondió bien."
• "Prueba estas 10 preguntas frecuentes y márcame en cuáles la respuesta fue incompleta o incorrecta" — y luego "corrige el conocimiento para las que fallaron y vuelve a probar".
• Antes de la temporada: "Verifica que el asistente responda bien sobre horarios, políticas, formas de pago y cómo llegar, y corrige lo que esté desactualizado."
• Diagnóstico de una respuesta: "En esta conversación el asistente dijo que la piscina es climatizada y no lo es: ¿por qué lo dijo?" — obtienes un veredicto (falta de información en el conocimiento, error real, no fue error…) y, según el caso, la corrección o el reporte a nuestro equipo.

Configuración y estado (Administrador)

• "¿El asistente está activo? ¿En qué horario responde?"
• "Pausa el asistente" / "Reactívalo" — afecta a todos los huéspedes de la cuenta, así que pídele a tu IA que te solicite confirmación antes de aplicarlo.
• Los horarios de atención se consultan desde aquí pero se cambian en la pantalla Configuración del panel.

Ayuda sobre WeSpeak (todos los roles)

• "¿Cómo configuro los mensajes de seguimiento?", "¿Qué incluye Multicuenta?" — tu IA busca en estas guías y te responde con el enlace al artículo.

Consejos para pedirle bien

• Sé concreto con período, canal y estado: "abiertas de esta semana en Instagram" da mejores resultados que "las conversaciones".
• Lista primero, acción después en cualquier cambio masivo.
• Nombra la propiedad si tienes varias cuentas conectadas.
• Pide el formato que necesitas (tabla, lista, informe corto) y en qué idioma.
• Si algo no se puede hacer desde tu IA, te lo dirá y te indicará si se hace en el panel o con tu asesor.

Qué puede modificar (y qué no)

La mayoría de las herramientas solo consultan. Desde tu IA se puede:

• Pausar o reactivar el asistente. Es lo único editable de su configuración: los horarios de atención y la zona horaria se ven, pero se cambian en el panel.
• Editar el conocimiento del asistente. Cada cambio se valida antes de aplicarse, guarda un respaldo y se puede deshacer.
• Cambiar el estado de una conversación (asignarla, cerrarla, reabrirla o posponerla). Nunca edita el contenido de los mensajes.
• Mover un lead de etapa. Las etapas del embudo se consultan, pero su estructura no se edita desde aquí.
• Reportar un problema a nuestro equipo cuando una respuesta del asistente estuvo mal.

Los mensajes de prueba son simulaciones: no quedan guardados ni le llegan a nadie. Y el conector no envía mensajes a tus huéspedes: sirve para operar tu cuenta, no es un canal de atención — tu asistente de WhatsApp sigue atendiendo igual que siempre.

⚠️ Importante: tu IA actúa según lo que tú le pides, sin un paso de confirmación extra de WeSpeak en el medio. Revisa lo que te propone antes de decirle que lo aplique — sobre todo al editar conocimiento. Como red de seguridad, esos cambios guardan respaldo y se pueden deshacer.

Seguridad y privacidad

• Tus permisos de siempre: tu IA puede hacer exactamente lo mismo que tú puedes hacer en el panel con tu usuario — ni más ni menos — y solo ve los datos de tu cuenta.
• Todo queda a tu nombre: las ediciones de conocimiento y los reportes registran quién los hizo.
• Tu conversación es privada: WeSpeak no ve lo que hablas con tu IA ni lo que te responde; solo recibe las acciones que ejecuta sobre tu cuenta.
• Revocable cuando quieras: elimina el conector desde los ajustes de Claude o ChatGPT y se corta el acceso de tu usuario. Si quieres desactivar la función para toda la cuenta, pídeselo a tu asesor.

Si manejas varias propiedades

Cada conexión queda atada a una cuenta de WeSpeak. Para manejar varias propiedades, agrega una conexión por cuenta: cada cuenta tiene su propia URL de conexión (el final ?username= las distingue, y cada URL identifica un conector aparte), que copias de la pantalla Configuración del panel de esa cuenta. Todas pueden convivir en la misma aplicación de IA, cada una se anuncia con el nombre de su cuenta y ve solo sus datos. Al pedirle algo a tu IA, aclara de qué propiedad se trata, para que use la conexión correcta.

Solución de problemas

Límites actuales

• Las opciones documentadas son Claude (claude.ai) y ChatGPT web (chatgpt.com). Para ChatGPT, sigue el instructivo desde la versión web. Si quieres usar Gemini, otra aplicación o una configuración distinta, consulta a tu asesor para verificar la compatibilidad antes de configurarla.
• No envía mensajes a huéspedes ni cambia cómo tu asistente atiende WhatsApp.
• Es una herramienta conversacional joven. Si una herramienta responde raro o un pedido no sale como esperabas, repórtaselo a tu asesor: nos ayuda a mejorarla.

Preguntas frecuentes

¿Funciona con ChatGPT?
Sí, con ChatGPT en su versión web. Usa los datos de la pestaña ChatGPT en Configuración y elige OAuth con el Client ID de WeSpeak y el secreto vacío. El acceso depende de que tu cuenta permita agregar conectores personalizados.

¿Reemplaza al asistente del panel?
No, conviven: las mismas herramientas siguen disponibles en el panel y, además, en tu IA. Usa cada uno donde te quede más cómodo.

¿Tiene costo adicional? ¿Quién paga la IA?
El uso de la IA corre por tu cuenta de Claude o ChatGPT — WeSpeak no te cobra por consulta. Confirma con tu asesor si la función está incluida en tu plan.

¿Puede mi IA responderles a mis huéspedes?
No. El conector opera tu cuenta (conversaciones, leads, métricas, conocimiento), pero no le escribe a nadie. Eso sí: editar el conocimiento desde aquí impacta en lo que tu asistente responde — igual que editarlo desde el panel.

¿Pueden conectarse varias personas del equipo?
Sí: cada una conecta su propia cuenta de Claude o ChatGPT con su propio usuario de WeSpeak y ve las herramientas de su rol.

Lo que hago desde mi IA, ¿vale igual que hacerlo en el panel?
Sí — y queda registrado a tu nombre. Tu IA actúa sobre tu cuenta a partir de lo que tú le pides, así que revisa lo que te propone antes de aplicarlo; los cambios de conocimiento guardan respaldo y se pueden deshacer.

¿Cómo lo desconecto?
Elimina el conector de WeSpeak desde los ajustes de Claude o ChatGPT y el acceso de tu usuario se corta. Si quieres desactivar la función para toda tu cuenta, pídeselo a tu asesor.