Centro de Ayuda
Inicio Office Recepcionista IA

Recepcionista IA: configurar integraciones API

Válido para tu Recepcionista IA

La funcionalidad API del servicio de Recepcionista IA permite la conexión de sistemas de terceros a través de interfaces REST. Esto habilita el intercambio bidireccional de datos (p.ej.: consultas al sistema CRM, creación de tickets, etc.) durante una llamada activa.

Nota

La configuración de integraciones de API requiere conocimientos avanzados de programación (REST, JSON). Si no tienes experiencia en este campo, te recomendamos realizar la configuración junto con tu personal de IT o desarrollo web.

Requisito

  • Eres cliente de IONOS con un contrato de Recepcionista IA All-Flat Advanced

Ejemplos de aplicación y ventajas

Gracias a las integraciones de API, tu Recepcionista IA puede ejecutar acciones en tiempo real y personalizar las conversaciones en función de datos actualizados. De este modo, funciona como una parte activa de tu equipo. 

Caso de uso Sistemas de ejemplo Ventajas
Gestión de la relación con el cliente (CRM) Salesforce, HubSpot y Pipedrive Puede identificar inmediatamente a las personas que llaman por su número de teléfono, consultar los datos del cliente (p.ej.: el estado del pedido) y ofrecer asistencia personalizada.
Calendario y herramientas de reserva Google Calendar, Calendly y Outlook Puede reservar, reprogramar o cancelar citas comprobando la disponibilidad en tiempo real.
Marketing HubSpot (correo electrónico) y Mailchimp Después de una llamada, puede añadir automáticamente a la persona que llama a una lista de correo (p.ej.: una newsletter) o crear un contacto comercial en el sistema.
Soporte y sistema de tickets Zendesk y Freshdesk Puede crear automáticamente un nuevo ticket para solicitudes de soporte o consultar el estado de un ticket existente.

Requisitos previos y técnicos

Para la configuración se requieren conocimientos técnicos especializados, así como acceso al sistema de destino. Por favor, comprueba de antemano los siguientes puntos:

  • Endpoint de la API: necesitas acceso a un sistema externo que pueda recibir solicitudes a través de una API REST pública.
  • Autenticación: prepara tus datos de acceso (p. ej.: clave API, token de portador, Basic Auth). Nota: Actualmente no se admiten flujos de OAuth interactivos (ventana de inicio de sesión).
  • Conocimientos de API: para la configuración es necesario tener conocimientos básicos de API REST, los métodos HTTP (GET y POST) y los formatos JSON.
  • Responsabilidad: serás responsable de la gestión, la seguridad y la disponibilidad (uptime) de la API conectada. Los endpoints con errores pueden provocar que tu Recepcionista IA interrumpa la conversación.

Funcionamiento técnico

Tu servicio de Recepcionista IA actúa como cliente HTTP. Su configuración consta de dos componentes principales:

  • «Parameters» (JSON Schema): establece qué información debe solicitar tu Recepcionista IA a la persona que llama antes de que se envíe la solicitud (p. ej.: ID de cliente, fecha, etc.).
  • «Request Definition» (HAR JSON): aquí se define la llamada a la API propiamente dicha. En este apartado, los parámetros recopilados se inyectan en la URL, el encabezado o el cuerpo de la solicitud.

Configurar la interfaz: añadir integración API

  • Inicia sesión en tu cuenta IONOS.
  • En la barra de menú superior, haz clic en Menú > Recepcionista IA. Se abrirá la interfaz correspondiente.
  • Opcional: si dispones de varios contratos del servicio de Recepcionista IA, haz clic en el menú desplegable situado en la parte superior izquierda (con el nombre de tu contrato actual) para abrir la lista de todos los contratos y seleccionar el que desees utilizar.
  • Abre la sección de Integraciones API y haz clic en + Añadir integración. Se abrirá una ventana emergente.

Ahora, tienes dos opciones para crear la definición:

Opción A: «Modo asistido por LLM»

Para ahorrar tiempo al crear la sintaxis del formato HAR, puedes utilizar el prompt proporcionado para que un modelo extenso de lenguaje (LLM) externo genere el código (p. ej.: ChatGPT, Claude).

Importante

No reveles credenciales de acceso en herramientas de IA externas. Introduce las claves o tokens exclusivamente en el cuadro de diálogo de IONOS.

  • En el Paso 1, selecciona tu herramienta de IA preferida a través del menú desplegable (icono de flecha) y, a continuación, haz clic en el botón. Se abrirá la página web del proveedor seleccionado en una nueva pestaña del navegador.

  • Por lo general, el prompt necesario para la creación se transfiere automáticamente al campo de entrada del chat.
     

    Recomendación: Según la herramienta de IA elegida, es posible que el prompt no se ejecute automáticamente. En ese caso, pulsa manualmente la tecla Enter para enviarlo. Si el campo de entrada permanece vacío, puedes simplemente pegar el prompt haciendo clic con el botón derecho (o Ctrl+V / Cmd+V) desde tu portapapeles.

  • Responde en el chat a las preguntas sobre la API deseada. 

  • Copia el bloque JSON generado por la IA. 

  • A continuación, vuelve al diálogo de IONOS y pega el código en el campo de texto del Paso 2. 

  • Haz clic en Aplicar y luego en Guardar cambios en la parte superior derecha.

Opción B: «Modo experto» (manual)

Esta es la vía directa para personal técnico que ya disponga del código necesario (formato JSON).

  • Haz clic en Modo experto en la esquina superior derecha de la ventana emergente y se abrirá otra ventana.
  • Completa los campos necesarios:
    • Nombre: asigna un único nombre.
    • Descripción: indica al LLM cuándo se debe activar esta herramienta.
    • Parámetros: define los parámetros que tu Recepcionista IA debe solicitar a la persona que llama. La entrada debe estar en formato JSON.
    • Solicitud: define la solicitud de API en formato HAR. Utiliza {{ variableName }} para hacer referencia a los parámetros definidos anteriormente. La entrada debe estar en formato JSON.
  • Haz clic en Aplicar y luego en Guardar cambios en la parte superior derecha.

Contenido