Antes de empezar
- Necesitas una cuenta activa de administrador de Visito para el negocio que conectarás.
- Usa Codex compatible con MCP remoto, ChatGPT con acceso a MCP personalizado o Claude con conectores personalizados. En un espacio administrado de Claude, su propietario puede tener que agregar primero el conector.
- Para probar mensajes, elige un contacto y canal que tengas autorización para usar. Leer conversaciones no requiere permiso de envío.
1. Agrega Visito
- Codex
- ChatGPT
- Claude
Pídeselo a Codex
Agrégalo manualmente
En la aplicación de escritorio, abre Settings → MCP servers → Add server. Usavisito como nombre, elige Streamable HTTP y pega la URL de arriba. Guarda, selecciona Restart cuando aparezca y después Authenticate. Completa la autorización en Visito. Estos son los controles documentados por OpenAI; pueden variar según la versión.Como alternativa, con la CLI de Codex instalada, ejecuta:
2. Inicia sesión y elige tu negocio
La conexión abre el inicio de sesión habitual de Visito. Usa tu cuenta de administrador registrada o Google si así accedes normalmente. Al terminar, vuelves a Conectar Visito.
Inicio de sesión habitual de Visito, antes de introducir credenciales.
3. Elige los permisos
Todos los dominios empiezan Sin acceso. Selecciona solo lo necesario:
Los dominios de solo lectura ofrecen Sin acceso y Leer. Leer todo, Leer y escribir todo y Quitar todo actúan sobre los permisos disponibles en la solicitud. Solicitud limitada indica que el asistente pidió solo parte de un dominio; abre los detalles para revisar las acciones exactas.
Selección de prueba limitada: lectura de canales y plantillas, con permisos personalizados de conversaciones. Interfaz en inglés; los datos de la cuenta quedan fuera de la captura.
Deja el resto Sin acceso. Pulsa Conectar después de revisar cuenta, negocio y acciones. Las aprobaciones de herramientas que pidan Codex, ChatGPT o Claude son independientes: no amplían los permisos de Visito.
4. Haz una prueba de lectura
Primero identifica la conexión:nextCursor y comprobar hasMore. La primera página no representa todos los resultados; la actividad nueva puede modificar una lista en vivo.
5. Envía una respuesta de prueba
Usa tu propio contacto de prueba. Sustituye los dos marcadores por un nombre verificado y un teléfono completo con código de país antes de enviar el prompt.6. Administra o desconecta la aplicación
- Abre el negocio correcto en el dashboard de Visito.
- Ve a Desarrolladores → Claves API y apps.
- En el filtro de tipo de acceso, elige Aplicaciones conectadas.
- Abre Ver permisos en tu conexión para revisar dominios, creador y actividad.
- Para revocarla, pulsa Desconectar aplicación y confirma la conexión indicada.
El panel de permisos incluye la acción de desconectar. Este ejemplo muestra una conexión con más permisos que los recomendados para la prueba.
Solución de problemas
Para detalles técnicos, consulta la documentación de la API. Visito comprueba el negocio y los permisos de la conexión en cada operación.
Acciones e inspección
Usa los nombres MCP de Acciones para gestionar HTTP, Sheets y recopilación.get_action_execution permite includeInspection: true con los permisos explícitos action_executions:read y action_inspection:read; en consentimiento, selecciona Detalles de ejecución. Las respuestas guardadas pueden contener datos de clientes. includeParameters y su permiso siguen separados. Inspeccionar no ejecuta acciones. Las pruebas directas siguen siendo solo HTTP, con confirmación por solicitud para escrituras; usa el área de pruebas para Sheets/recopilación. Tools sigue disponible, obsoleto, sin fecha final de retiro. Consulta la guía y migración de Acciones.
Resúmenes de conversaciones con IA
Cuando están disponibles,list_conversations y get_conversation devuelven el mismo campo opcional aiSummary que GET /m2m/v1/conversations y GET /m2m/v1/conversations/{conversationId}. Describe los temas principales y el estado actual en un párrafo breve, en el idioma del cliente. Incluye conversaciones independientemente del CRM o de su clasificación como prospectos.
generatedAt indica cuándo se generó el resumen. throughMessageAt identifica el mensaje externo más reciente incluido. isStale es verdadero mientras queda actividad nueva o historial pendiente de procesar. El campo se omite hasta que exista un resumen. Los resúmenes se actualizan de forma asíncrona después de una breve pausa; una conversación activa puede mostrar temporalmente un resumen anterior.
Lee primero el resumen para identificar temas y obtener contexto inicial. Consulta los mensajes si falta el resumen, está desactualizado o necesitas detalles de respaldo. El resumen no sustituye los campos oficiales de needsReply, reservas, pagos ni entrega de mensajes.
Leer adjuntos de mensajes
El asistente puede abrir el historial visible para el cliente conlist_conversation_messages. Puede revisar texto, referencias de respuesta, reacciones, contactos, ubicaciones y selecciones interactivas, además de los metadatos de adjuntos. Las listas y los resúmenes de IA son un punto de partida; un resumen ausente/desactualizado requiere leer mensajes para obtener contexto actual.
Para un adjunto de imagen, documento, audio o video, usa get_conversation_attachment con conversationId, el messageId almacenado y media[].attachmentIndex del historial. Usa el permiso de lectura de conversaciones existente. Por defecto devuelve metadatos, estado de procesamiento y contexto existente de audio/video. pending, failed, timed_out y unavailable no significan mensajes vacíos ni procesamiento correcto.
Solicita includeContent: true solo cuando necesites la imagen o el archivo. MCP devuelve imágenes como contenido nativo y otros archivos admitidos como recursos incrustados. La posibilidad de mostrarlos/leerlos depende del cliente MCP. El Agent integrado de Visito guarda imágenes y archivos autorizados en su espacio privado de análisis sin acceso a la red. Abre las imágenes con el visor nativo antes de describirlas.
file/sticker siguen siendo legibles; no pasan a ser formatos nuevos para envíos. Actualiza las herramientas en caché cuando se despliegue el nuevo lector. Consulta el contrato de mensajes y adjuntos para estados y ejemplos.
La inspección de imágenes también limita cada lado a 4.096 píxeles y el total a 16 megapíxeles. GIF/WebP animados y encabezados inválidos/demasiado grandes devuelven unsupported; no se interpretan silenciosamente como una animación completa. La lectura de metadatos sigue disponible.
Disponibilidad y compatibilidad
Esta actualización del código del 13 de octubre de 2026 es aditiva y se verificó localmente mediante API/MCP autenticados y con imágenes/archivos sintéticos en el entorno administrado del Agent. El cambio por sí solo no despliega ni activa la función en producción. Despliega primero el lector compatible de API/MCP y después el Agent; actualiza las definiciones de herramientas almacenadas en caché. Los estados y el contexto de video existentes se leen sin migración ni reparación histórica. La generación de resúmenes de IA tiene un interruptor global independiente; la ausencia de un resumen es una respuesta válida. La lectura conserva el permisoconversations:read. Un error de procesamiento o inspección no autoriza enviar mensajes, repetir la ingestión, reintentar escrituras ni modificar registros del cliente. Los clientes MCP externos necesitan soporte de imágenes/archivos nativos para interpretar los bytes. La biblioteca administrada de Assets/Knowledge es una función separada.
Explicar una respuesta de IA guardada
Pide al agente que inspeccione por qué se produjo una respuesta específica.get_conversation_answer_trace consulta llamadas guardadas del planner, recibos de fuentes RAG y entradas/salidas de respuesta. Las conexiones externas necesitan Diagnóstico de conversaciones → Lectura (conversations:debug:read) separado del acceso normal; las concesiones existentes no cambian. El agente integrado hereda el acceso vigente del administrador. Por defecto devuelve metadatos; el contenido solicitado es limitado y saneado. Debe indicar evidencia ausente/vencida/parcial/demasiado grande/truncada. La lectura no reproduce herramientas ni envía mensajes. El lector está implementado localmente; requiere su despliegue compatible para producción. Consulta contrato y límites.
Leer historiales largos de derivación
list_conversation_handoffs devuelve hasta treinta casos de derivación/revisión por página. Sigue nextCursor hasta hasMore=false. Cada caso muestra solo cinco eventos recientes; continúa los anteriores con list_conversation_handoff_events y eventsNextCursor (por defecto cincuenta/máximo cien). Conserva los límites del cursor e indica datos ausentes/demasiado grandes. Consulta la propiedad actual en los metadatos de conversación. Ambos usan conversations:read; leer no resuelve casos ni envía notificaciones. La actualización está verificada localmente; requiere índices y esquemas MCP actualizados al desplegar. Contrato.
Elegir la herramienta de evidencia de conversación
Las descripciones MCP indican cuándo usar cada herramienta, de dónde obtener sus identificadores y dónde consultar la siguiente evidencia. La actualización del código del 13 de octubre agrega esta orientación y conserva las descripciones de parámetros de la API en las entradas MCP. Requiere despliegue de API y actualización de herramientas; las descripciones no conceden permisos.
Mensajes, derivaciones y acciones siguen siendo fuentes de evidencia independientes. No hay un enlace público universal de cada acción a una respuesta exacta; no lo infieras solo por las horas.
Conocimiento y configuración de la IA para clientes mediante MCP
La continuación local del 13 de octubre de 2026 expone capacidades existentes de conocimiento y configuración de IA para clientes. Despliega los servicios compatibles y actualiza las definiciones de herramientas antes de usarlas. Selecciona permisos de lectura/escritura de Conocimiento y los permisos independientes de Personalidad de IA; las conexiones existentes no obtienen acceso automáticamente. El diagnóstico de respuestas guardadas conserva su permiso separado.
La personalización afecta respuestas a clientes/Playground; los borradores de seguimiento del CRM la usan mediante su propio resolver. No configura Support Copilot ni el Business Agent administrado. compiledSystemPrompt es una vista previa; runtimePersonalization contiene los campos almacenados y verbose heredado. Reglas centrales, herramientas, conocimiento, canal/propiedad/conversación y configuración de respaldo también influyen.
Para “¿Por qué mi IA respondió esto?”, comienza con el mensaje y get_conversation_answer_trace. Usa conocimiento/configuración actuales para diagnosticar el presente; no prueban las versiones usadas antes. Declara capturas ausentes/caducadas/truncadas y vínculos/versiones faltantes. No reproduzcas herramientas, llames proveedores, actives capturas, envíes mensajes ni cambies configuración solo para explicar una respuesta guardada.
Consulta Knowledge API y Configuración de IA. Ante 409, vuelve a leer y reconcilia. Ante ingestión/rastreo/eliminación inciertos, descubre el estado antes de reintentar. Una fuente puede guardarse inactiva por cuota; aceptado/en cola no significa listo ni relevante.
Enlaces de conexión de canales
Para agregar un canal Meta, pide al agente conectado que revise opciones y cree un enlace temporal. Ábrelo personalmente, inicia sesión como administrador del negocio previsto y completa autorización/selección de recursos. Instagram, Messenger y WhatsApp tienen pasos distintos. Pide al agente que revise el intento guardado y los canales resultantes antes de declarar éxito. El enlace vence en 15 minutos y requiere el permiso de conexión por separado. Webchat requiere instalar un snippet; TikTok mantiene su configuración nativa controlada. Consulta herramientas y recuperación. Requiere publicar versiones compatibles; los enlaces permanecen desactivados hasta habilitarlos en la instalación.Pregunta cómo funciona Visito
Con el permisoknowledge:read, el asistente puede usar search_visito_docs para
buscar guías publicadas del producto y la API en español o inglés, y después
read_visito_doc para leer una página relevante. Por ejemplo: “¿Cómo funcionan
los campos obligatorios de escalamiento? Explícalo con la documentación de
Visito e incluye los enlaces de las fuentes.”
Estas herramientas consultan documentación cuando hace falta; no cargan un
manual fijo ni leen la base de conocimiento de tu negocio. La documentación
explica el comportamiento del producto; otras consultas autorizadas verifican
tu configuración real. Los resultados incluyen enlaces y avisan si el contenido
está truncado. Los cambios publicados aparecen después de la indexación y una
caché de hasta 60 segundos. Estas lecturas no cobran un crédito adicional por
acción de Lana; siguen aplicando los cargos normales por turno y acción del negocio.
Las dos herramientas requieren versiones compatibles de la plataforma y Lana.
El MCP público de documentación es https://docs.visitoai.com/mcp; Visito expone
solo búsqueda y lectura, sin enviar comentarios ni aceptar comandos arbitrarios.
Buscar chats por acciones de disponibilidad o reserva
Para exportar por acciones, pide usarlist_conversations con actionId/actionStatus antes de leer mensajes. Selecciona chats recientes por historial proyectado. Para acciones ejecutadas durante un período específico, usa list_action_executions con fechas explícitas y omite conversationId; pagina y deduplica antes de leer metadatos de contacto. Checkout completado no confirma pago/reserva; indica historial ausente y cobertura. Ejemplos y criterios. Los filtros nuevos requieren desplegar la API y actualizar herramientas.
Gestionar tickets
Concede explícitamente acceso a Tickets y, cuando corresponda, creación/gestión de escalaciones. Sigue el flujo descubrir → inspeccionar evidencia → elegir persona → iniciar → añadir notas → resolver → leer de nuevo. Las respuestas al cliente usan herramientas independientes.Resumen del negocio
Usaget_business_overview para orientar al agente antes de trabajar con el
contexto del negocio. Resume el negocio conectado, los canales guardados,
integraciones y capacidades de acciones, conocimiento y archivos compartibles,
configuración de IA y derivaciones, CRM comercial, productos y servicios,
actividad de los últimos 30 días y conteos actuales de atención.
No requiere un permiso OAuth adicional. Cada sección conserva su permiso de
lectura; los datos sin autorización, no disponibles o incompletos se indican
explícitamente y nunca se presentan como cero. La autenticación determina el
negocio. No incluye instrucciones completas, mensajes de clientes ni credenciales.
Los resultados incluyen fechas y vencimiento de caché (60 segundos). Usa
refresh: true después de cambiar la configuración. La configuración guardada no
confirma la salud actual del proveedor ni autoriza acciones; consulta las
herramientas de inspección y conserva las aprobaciones existentes. Esta herramienta
no añade un crédito de acción de Lana. La API autenticada es
GET /business/overview?refresh=true.
Gestionar trabajo de comercio
Usalist_tickets(includeCommerce=true, source=commerce), revisa get_ticket, elige un responsable humano, inicia trabajo y agrega notas. Con lectura de ventas y el permiso de escritura específico, llama a update_commerce_sale_fulfillment o reconcile_commerce_sale con sourceVersion actualizado e Idempotency-Key y consulta después el resultado. La conciliación registra evidencia; no confirma una reserva del proveedor. Resolver/Cancelar no omiten reglas de comercio. Reembolsos, transferencias y reintentos siguen siendo humanos.