Resumen
Un asistente telefónico con IA solo puede gestionar citas y datos de clientes de forma fiable si se comunica con el sistema que contiene la información válida. Los webhooks y las API permiten consultar datos durante una llamada y guardar resultados confirmados. Esta guía explica el flujo habitual, los errores y las medidas de protección, desde comprobar disponibilidad hasta añadir una nota al CRM.
El sistema conectado debe ser la fuente de verdad
Un modelo de lenguaje puede entender una fecha y formular preguntas útiles. No debe decidir por sí solo si hay una cita libre o si se ha modificado un registro. Esa información debe proceder del calendario, el CRM o el sistema de gestión de trabajos.
Un flujo seguro funciona así: el asistente identifica la acción solicitada; recoge y confirma los datos necesarios; una integración consulta el sistema de destino; este devuelve opciones disponibles o un error; el asistente comunica solo resultados confirmados; tras la aceptación de quien llama se envía la reserva o modificación; y el sistema confirma el resultado.
Si no existe una integración adecuada, el asistente puede registrar la solicitud de forma estructurada y enviarla al equipo, en lugar de fingir que ha reservado una cita.
APIs y webhooks: ¿en qué se diferencian?
Una API ofrece datos o funciones definidos a través de puntos de acceso técnicos. Un webhook suele ser una petición concreta enviada a uno de esos puntos durante un proceso. Por ejemplo, un asistente puede consultar citas libres o enviar al CRM los datos confirmados y el motivo de la llamada.
Con nuestros webhooks, los asistentes de VoiceBooker pueden consultar información actualizada de sistemas externos durante una llamada o enviarles datos confirmados. Las acciones disponibles también dependen de las interfaces y permisos del sistema conectado.
En los procesos de varias etapas, pueden conservar datos confirmados durante la conversación en el objeto State y enviarlos después a un webhook. Así, el asistente no vuelve a preguntar el nombre, el motivo o la opción elegida. Guarden y transfieran solo los valores que necesite el siguiente paso.
Ejemplo: reservar una cita por teléfono
Supongamos que un servicio de citas necesita el tipo de servicio, la sede, el horario preferido y los datos de contacto. El asistente debe recogerlos paso a paso y preguntar de forma concreta por los datos ausentes.
Comprobar disponibilidad
El asistente envía los criterios necesarios al calendario. Este devuelve los horarios libres y el asistente ofrece únicamente esas opciones para que la persona elija. Si no hay ninguna adecuada, puede preguntar por otro periodo o registrar una petición de devolución de llamada.
Confirmar la reserva
Cuando la persona elige un horario, se envía la solicitud de reserva. El asistente solo puede confirmar la cita después de recibir una respuesta satisfactoria del calendario. Si el sistema informa de un conflicto o no está disponible, no debe decir que la reserva se ha realizado.
Actualizar el CRM
Tras una reserva correcta, se puede crear una nota en el CRM con la cita, el motivo y los datos de contacto necesarios. Transfieran solo la información que necesita el siguiente paso. No hace falta guardar automáticamente una grabación completa.
Medidas técnicas y gestión de errores
Evitar acciones duplicadas
Tras un tiempo de espera agotado, quizá no esté claro si el sistema recibió la solicitud. Reintentar no debe crear una segunda cita sin que nadie lo advierta. Si el sistema lo permite, utilicen un identificador único y comprueben el estado actual de la reserva.
Validar los datos
Antes del envío, comprueben el formato de fecha, el teléfono, los campos obligatorios, los servicios admitidos y la sede. Para datos importantes, pidan confirmación en vez de adivinarlos a partir de una frase poco clara.
Explicar los errores con claridad
Definan qué ocurre si la integración no está disponible, los datos no son válidos o no llega una respuesta. Las alternativas pueden ser registrar una devolución de llamada, avisar al equipo o transferir la llamada. El asistente debe explicar el problema de forma sencilla y nunca afirmar que una acción se completó si no es así.
Reducir credenciales y datos
Las integraciones requieren autenticación. Guarden las credenciales de forma segura, limiten los permisos a las acciones necesarias y no incluyan secretos como tokens de API en los datos de conversación. Transfieran solo la información necesaria para cada tarea.
Probar antes de la puesta en marcha
Además de las solicitudes correctas, prueben fechas inválidas o incompletas; una cita ocupada justo antes de reservar; llamadas duplicadas y reintentos de API; identificación incorrecta del cliente; respuestas vacías, tiempos agotados y errores de servidor; cambios o cancelaciones rechazados por el sistema; y los mensajes para reservas correctas y fallidas.
Comparen el registro de la conversación con el sistema de destino: ¿coinciden los horarios, nombres y acciones?, ¿puede el equipo reconstruir después lo sucedido?
Conclusión
Conectar el CRM o el calendario permite que el asistente actúe, pero exige que las modificaciones sean correctas. El sistema debe confirmar la disponibilidad y los cambios; después, el asistente comunica el resultado con claridad. Desde el inicio, la integración debe incluir alternativas ante fallos, credenciales seguras y pruebas realistas.
Encontrarán más ejemplos en nuestras guías de webhooks y acceso a la API.