Saltar al contenido principal
Usa un sistema API personalizado cuando tu agente necesite información actual u operaciones de software que controlas: buscar un cliente, consultar un pedido o crear una oportunidad. El conector agrupa las acciones; la conexión guarda la URL base y la autenticación compartidas. Necesitas acceso de administrador, una API HTTPS accesible y sus credenciales. Crear un conector no crea un servidor ni proporciona acceso directo a una base de datos.

​
1. Añade tu sistema

Abre Conectores → Añade tu propio sistema → Basado en API. El modal Agregar tu sistema reúne la conexión compartida y las acciones que quieras crear ahora. Opciones Basado en API y Alojado en Visito dentro de Añade tu propio sistema. Asigna un nombre reconocible, como Mi CRM, y una descripción opcional. Ese nombre aparecerá en Instalados.

​
2. Configura la conexión compartida una vez

URL base y credencial Bearer compartidas por las acciones del sistema. La conexión se crea con el nombre Primary. Todas las acciones de este modal la usan. Guarda las credenciales aquí, nunca en las instrucciones de la IA ni en el esquema de entrada. Una clave API de Visito autentica llamadas a Visito; usa la credencial de tu sistema externo para esta conexión. Para editar los ajustes compartidos, abre Conexiones en el conector guardado y pulsa Primary. El panel derecho permite cambiar la URL base, la autenticación, la credencial y el estado habilitado. Deja el secreto vacío para conservar la credencial guardada. Los cambios se aplican a las acciones que usan esta conexión. Para añadir otro sistema, vuelve a Conectores → Añade tu propio sistema.

​
3. Define una o varias acciones

Cada acción describe una operación. Selecciona Agregar acción para añadir otra en el mismo modal; puedes crear de 1 a 20 a la vez. Expande una acción para editar sus ajustes. Para buscar un cliente, usa: El endpoint resultante es https://api.example.com/v1/customers/search. Introduce una ruta relativa a la URL base, en lugar de otra URL completa.

​
Explica cuándo y cómo debe usarla la IA

Incluye la intención, los datos faltantes, la confirmación y cómo interpretar la respuesta. Por ejemplo:
Una segunda acción, Crear oportunidad, puede usar POST con la ruta leads. Sus instrucciones deben pedir los datos necesarios, confirmar que el cliente quiere recibir seguimiento y comunicar el éxito solo cuando el CRM devuelva un ID.

​
Define las entradas

En Parámetros (JSON Schema), define la información que debe proporcionar el agente. Usa tipos, descripciones, formatos y campos obligatorios claros:
El agente puede reutilizar detalles ya compartidos y pedir los que falten. Tu API también debe validar las entradas y controlar el acceso a registros. Devuelve datos breves y apropiados para que el agente los explique al cliente.

​
Elige cómo se envían las entradas

GET envía las entradas como parámetros de consulta. Para POST, expande Opciones de la solicitud → Cuerpo de la solicitud: Cuerpo predeterminado con un correo de ejemplo:
El cuerpo predeterminado agrupa las entradas en arguments e incluye contexto. Cuerpo JSON directo para la misma entrada:
JSON directo seleccionado con un ejemplo del cuerpo enviado. Los valores de contexto varían por conversación; las pruebas directas usan contexto de prueba. El esquema define el objeto de entrada, no una plantilla arbitraria del cuerpo. Si el proveedor requiere transformaciones adicionales, OAuth con renovación o varias llamadas API, usa un endpoint adaptador. Para una ruta dinámica como customers/{customerId}, añade customerId en Parámetros en la ruta (opcional) y decláralo como entrada escalar obligatoria en el esquema. Separa varios nombres con comas. Usa cada marcador como un segmento completo de la ruta. Visito codifica el valor en ese segmento y lo excluye de los demás parámetros de consulta o del cuerpo.

​
Define los negocios, Solo lectura y el modo

Elige los negocios donde corresponde la operación. Usa Todos los negocios solo si los mismos datos y comportamiento aplican a todo el espacio de trabajo. Solo lectura significa que la acción consulta información sin modificar datos. Márcalo para Buscar cliente o Consultar estado del pedido. Déjalo sin marcar para Crear oportunidad, cambiar una reserva, eliminar un registro o enviar un mensaje. Declara el comportamiento de la operación; no impide que tu servidor modifique datos. Tu API debe aplicar ese comportamiento. Esquema, negocios, explicación de Solo lectura y modo de pruebas de cada acción. Las acciones nuevas empiezan en Solo área de pruebas. Inactiva impide nuevas llamadas; Activa permite usarlas en conversaciones elegibles de clientes y en el Área de pruebas. Cada acción puede tener un modo distinto.

​
4. Guarda el sistema

Revisa la conexión y cada acción; selecciona Crear sistema. El conector, la conexión y las acciones iniciales se guardan juntos. Si falla la validación, corrige los ajustes indicados y vuelve a intentarlo. Dos acciones agrupadas bajo una conexión compartida antes de crear el sistema. Llegas a Acciones dentro del nuevo sistema, que aparece una sola vez en Instalados. Selecciona Agregar acción aquí para crear otra acción dentro del mismo conector. La conexión compartida se selecciona automáticamente cuando es la única habilitada. Las configuraciones anteriores con varias conexiones guardadas conservan la selección explícita. Conector CRM guardado con dos acciones y el botón Agregar acción. La página de detalle solo permite añadir acciones. En Conexiones, pulsa la fila de la conexión compartida para abrir sus ajustes en el panel derecho. Usa el icono junto al nombre del conector para cambiar el nombre y la descripción del sistema. Los conectores nuevos se crean desde la página principal de Conectores. Conexión Primary compartida del conector. Al pulsar la conexión compartida, su URL base y autenticación se abren en el panel derecho. Las acciones HTTP independientes existentes conservan su configuración. Crear un conector no mueve automáticamente las acciones anteriores.

​
5. Prueba, inspecciona y activa

Las acciones API en el Área de pruebas envían solicitudes HTTP reales. Usa datos ficticios y un destino donde puedas probar las operaciones permitidas. Prueba una solicitud completa, datos faltantes, valores inválidos, ningún resultado y un fallo del servidor. Para escrituras, comprueba el registro de destino además de la conversación. Selecciona Ver actividad para revisar parámetros, respuesta, estado y tiempos. Los datos guardados de la solicitud pueden diferir del cuerpo POST completo; la autenticación se oculta o se redacta. Que una solicitud termine no demuestra que la operación haya tenido éxito. Consulta Probar y depurar acciones. Cuando la conversación y el destino funcionen, cambia la acción a Activa. Usa Inactiva para impedir futuras llamadas; esto no deshace una solicitud ya iniciada.

Ejemplo de estado del pedido

Recopila el número de pedido, envíalo al servidor, explica el resultado y sigue la ejecución.
Para configuración programática y pruebas directas compatibles, consulta la API de Acciones. El flujo del dashboard en un solo modal no implica que todos los clientes API o MCP tengan la misma operación de creación conjunta.