--- title: "API de Virtual Front Desk: descripción general y primeros pasos" url: "https://help.virtualfrontdesk.com/es/article/api-de-virtual-front-desk-descripcion-general-y-primeros-pasos" language: "es" last_updated: "2026-10-14T14:29:32.772Z" --- # API de Virtual Front Desk: descripción general y primeros pasos ## ¿Qué es la API de Virtual Front Desk? La API de Virtual Front Desk le permite conectar Virtual Front Desk con el otro software que su organización ya usa. En lugar de copiar la información a mano de un sistema a otro, sus sistemas pueden intercambiar información con Virtual Front Desk de forma automática. La API está diseñada para administradores de TI, desarrolladores y socios de integración, pero no necesita ser desarrollador para entender lo que puede hacer por usted. Este artículo ofrece una descripción general de las posibilidades y explica cómo empezar. La API está disponible en los planes **Professional** y **Enterprise**. ## Cómo funciona Hay tres formas de conectarse a Virtual Front Desk: - **La API:** su sistema solicita información a Virtual Front Desk, como los registros de entrada de sus visitantes o su historial de llamadas, y la recibe de inmediato. - **Los webhooks:** Virtual Front Desk notifica automáticamente a su sistema en el momento en que ocurre algo, por ejemplo cuando un visitante registra su entrada o una llamada queda sin respuesta. - **Los asistentes de IA:** conecta un asistente de IA a sus datos de Virtual Front Desk y hace preguntas en lenguaje sencillo, sin escribir código. ## Qué puede hacer con ella Cada organización es diferente, así que la mejor integración depende de sus necesidades y de los sistemas que ya usa. Estas son algunas ideas generales: - **Mantener informados sus otros sistemas:** haga que su propio software sepa cuándo llegan o se van los visitantes, para que las personas y los sistemas adecuados estén siempre al día. - **Llevar sus datos a sus propias herramientas:** use la información de sus visitantes y llamadas en las herramientas de informes o de inteligencia de negocios que ya usa. - **Anticiparse a los problemas:** reciba una alerta cuando una estación se desconecte o cuando se pierdan llamadas. - **Hacer preguntas sobre su actividad:** use un asistente de IA para obtener respuestas rápidas sobre sus visitantes, llamadas y estaciones. Le recomendamos hablar de su proyecto con su departamento de TI o su socio de integración. Nuestro soporte también puede ayudarle a evaluar lo que es posible para su organización. ## Antes de empezar - Su organización debe tener el plan **Professional** o **Enterprise**. - Solo los usuarios con el rol de **Propietario** (Owner), **Administrador** (Admin) o **Gerente** (Manager) pueden acceder a la configuración de la API en el panel de control de Virtual Front Desk. ## Abrir la página de la API Haga clic en el icono de **Configuración** (Settings) (el engranaje) junto a su nombre y luego, en **Organización** (Organization), seleccione **API**. La página se divide en cinco secciones, que se explican a continuación. ![La página API en Configuración > Organización](https://cdn-assets.productfruits.com/ba2a202a-465d-4f32-a043-bc46026da3cd) *La página API en Configuración > Organización* ## 1\. API Esta sección muestra la **URL base** (Base URL), la dirección que usan sus sistemas para conectarse a Virtual Front Desk. Haga clic en **Copiar** (Copy) para copiarla. El botón **Referencia de la API** (API reference) abre la documentación técnica completa, que su desarrollador o socio de integración usará para crear la integración. ## 2\. Claves de API Una clave de API es la credencial que usa su sistema para conectarse a Virtual Front Desk. Cada clave tiene sus propios permisos, llamados **alcances** (scopes), para que cada integración solo tenga acceso a lo que necesita. Para cada clave, la lista muestra su nombre, el inicio de la clave, sus alcances y cuándo se usó por última vez y cuándo se creó. Hay dos botones disponibles: - **Reemplazar secreto** (Replace secret): asigna un nuevo secreto a la clave, por ejemplo si cree que pudo haber quedado expuesta. El secreto anterior deja de funcionar de inmediato, así que actualice su integración enseguida. La clave conserva su nombre, sus alcances y su historial de uso. - **Revocar** (Revoke): desactiva la clave de forma permanente. Cualquier integración que la use deja de funcionar de inmediato. Las claves revocadas y vencidas pasan a **Claves inactivas** (Inactive keys) al final de la lista. **Para crear una clave:** 1. Haga clic en **Crear clave** (Create key). 2. Ingrese un **Nombre de la clave** (Key name) que describa la integración. 3. Elija los **Alcances** (Scopes). Puede seleccionar **Acceso completo** (Full access), **Solo lectura** (Read only) o **Solo escritura** (Write only), o seleccionar permisos individuales para cada área. Otorgue solo lo que la integración necesita. 4. De forma opcional, establezca una **Fecha de vencimiento** (Expiry date). La clave deja de funcionar al final de ese día. Si lo deja vacío, la clave nunca vence. 5. Haga clic en **Crear clave**, luego copie la clave y guárdela en un lugar seguro. ![Creación de una clave de API](https://cdn-assets.productfruits.com/176fa09d-1e3e-48ba-ac49-e2b5420dbef9) *Creación de una clave de API* La clave completa se muestra solo una vez. Si se pierde, cree una clave nueva y revoque la anterior. ## 3\. Asistentes de IA (MCP) Esta sección le permite conectar un asistente de IA, como Claude Code, Cursor o VS Code, a sus datos de Virtual Front Desk para hacer preguntas en lenguaje sencillo. - **Solo lectura** (Read-only): la dirección que debe usar cuando el asistente solo deba leer su información. Es la opción recomendada. - **Con escritura** (With writes): la dirección que debe usar cuando el asistente también deba poder hacer cambios, siempre que su clave de API tenga permisos para hacerlo. - Las pestañas de abajo muestran un comando de configuración listo para copiar para cada herramienta de IA. Reemplace el final del comando por una clave de API creada en la sección anterior. ![La sección Asistentes de IA (MCP)](https://cdn-assets.productfruits.com/1f2c699d-5406-4c83-8526-4f989b6f334a) *La sección Asistentes de IA (MCP)* La información que lee el asistente, incluidos los datos de los visitantes, se envía a su proveedor de IA. Le recomendamos crear una clave exclusiva con fecha de vencimiento para su asistente. ## 4\. Webhooks Los webhooks permiten que Virtual Front Desk notifique automáticamente a sus sistemas cuando ocurre algo. Haga clic en **Agregar endpoint** (Add endpoint) para ingresar la dirección del sistema que debe recibir las notificaciones. Cada notificación está firmada, para que su sistema pueda verificar que realmente proviene de Virtual Front Desk. ## 5\. Uso Para cada uno de los últimos 14 días, esta sección muestra el número de solicitudes a la API realizadas con todas sus claves y el número de errores, con un desglose por endpoint. Se actualiza una vez al día con los totales del día anterior. ![Las secciones Webhooks y Uso](https://cdn-assets.productfruits.com/38e3257f-714b-45ce-bfb4-731826bb0591) *Las secciones Webhooks y Uso* ## Mantenga segura su integración - Cree una clave distinta para cada integración, para poder revocar una sin afectar a las demás. - Otorgue a cada clave solo los permisos que necesita. - Guarde sus claves en un lugar seguro y nunca las comparta por correo electrónico o chat. - Si una clave pudo haber quedado expuesta, haga clic de inmediato en **Reemplazar secreto** o **Revocar** en **Configuración > Organización > API**. ## Más información La documentación técnica completa está disponible en la [**referencia de la API de Virtual Front Desk**](https://api.virtualfrontdesk.com/v1/docs) (en inglés). También puede abrirla con el botón **Referencia de la API** en **Configuración > Organización > API**. ¿Necesita ayuda para planificar una integración? Comuníquese con nuestro soporte y con gusto le ayudaremos.