Integrando la API de Tess AI en tus Flujos de Trabajo
Este artículo explica cómo usar la API de Tess AI para integrar inteligencia artificial en tus flujos de trabajo externos, automatizando tareas y enriqueciendo datos.
Principios de la API
La API permite que aplicaciones externas accedan a las funcionalidades de Tess AI, como la ejecución de agentes, el procesamiento de lenguaje natural y otras tareas de IA. Esto posibilita la integración de la IA en tus propios sistemas, aprovechando el entrenamiento y los prompts configurados en la plataforma Tess AI.
Ejemplo de Uso (Transcripción y Generación de Actas)
Un administrador de escuela puede automatizar la generación de actas de reuniones. Graba la reunión, guarda el video en Google Drive y la API de Tess AI se activa. El audio se transcribe usando servicios como Deep Grun, AssemblyAI, Have.ai o Whisper de OpenAI. La transcripción es entonces procesada por un agente en Tess AI, entrenado para generar el acta formateada.
Novedades de la API
Tess AI está en constante desarrollo y nuevas funcionalidades se añaden regularmente. Mantente atento a las novedades en la documentación de la API.
Accediendo a la API
Existen dos maneras principales de acceder a la API:
AI Studio (Automations): Crea automatizaciones que disparan webhooks para tus agentes/plantillas.
API Tokens: Genera un token de acceso en la sección "API Tokens" de tu perfil y utilízalo para autenticar tus solicitudes. La documentación completa de la API está disponible en el menú superior de la plataforma.
Caso Práctico: Clasificación de Feedbacks: Automatización para clasificar feedbacks de clientes (sentimiento, categoría, motivo) con base en nuevas entradas en una hoja de cálculo.
Integración con Zapier (paso a paso)
Autenticación: Autentícate en Zapier con tu token de la API de Tess AI.
Nuevo Zap: Crea un nuevo Zap.
Gatillo: Elige el gatillo "Nueva Línea en la Hoja de Cálculo" (Google Sheets).
Seleccionar Hoja de Cálculo: Selecciona la hoja de cálculo y la pestaña que contiene los feedbacks.
Acción: Ejecutar Plantilla: Añade la acción "Ejecutar Plantilla" (Tess AI App).
Seleccionar Plantilla: Elige la plantilla de clasificación de feedbacks.
Mapear Campos: Mapea los campos "feedback" y "estrellas" de la hoja de cálculo a los parámetros correspondientes de la plantilla.
Webhook Callback URL (para segundo Zap): Configura el "Webhook Callback URL" para un segundo Zap que procesará la respuesta.
Segundo Zap - Gatillo: Crea un segundo Zap con el gatillo "Catch Hook".
Copiar URL del Webhook: Copia la URL del webhook generada en el segundo Zap y pégala en el campo "Webhook Callback URL" del primer Zap.
Segundo Zap - Mapear Campos: En el segundo Zap, mapea los campos de la respuesta de Tess AI ("sentimiento", "categoría", "motivo") a las columnas correspondientes en la hoja de cálculo.
Segundo Zap - Acción: Actualizar Línea: Añade la acción "Actualizar Línea en la Hoja de Cálculo" (Google Sheets).
Mapear ID de la Línea: Mapea el ID de la línea para garantizar que el registro correcto sea actualizado.
Alternativa (Delay): Como alternativa al segundo Zap, usa la acción "Delay" en el primer Zap para esperar la respuesta de Tess AI. Esto simplifica el flujo, pero puede ser menos eficiente para procesamientos demorados.
Integración con Make (paso a paso)
Nuevo Escenario: Crea un nuevo escenario en Make.
Gatillo: Añade el gatillo "Observar cambios en la hoja de cálculo" (Google Sheets).
Seleccionar Hoja de Cálculo: Selecciona la hoja de cálculo y la pestaña que contiene los feedbacks.
Módulo HTTP (POST): Añade el módulo "HTTP" y configura el método para POST.
URL de Ejecución: Configura la URL de ejecución de la plantilla (consulta la documentación de la API de Tess AI).
Cabecera Authorization: Añade la cabecera "Authorization" con el valor "Bearer <tu_token>".
Cuerpo de la Solicitud: En el cuerpo de la solicitud, informa los parámetros ("feedback", "estrellas") en formato JSON o "multipart/form-data".
Almacenar ID de la Ejecución: Añade un módulo "Set Variable" para almacenar el ID de la ejecución retornado por la API.
Módulo Repeater (Polling): Añade un módulo "Repeater" para implementar el polling.
Intervalo de Polling: Configura el intervalo de tiempo entre las verificaciones de estado.
Módulo HTTP (GET) dentro del Repeater: Dentro del repeater, añade un módulo "HTTP" con el método GET.
URL de Verificación de Estado: Configura la URL de verificación de estado (de la documentación de la API), incluyendo el ID de la ejecución almacenado anteriormente.
Cabecera Authorization (GET): Añade la cabecera "Authorization" con el valor "Bearer <tu_token>".
Condición de Parada del Repeater: Configura el repeater para parar cuando el campo "status" de la respuesta sea "success" o "fail".
Extraer Datos de la Respuesta: Después del repeater, añade un módulo "Set Variable" para extraer los datos de la respuesta ("sentimiento", "categoría", "motivo").
Actualizar Hoja de Cálculo: Añade el módulo "Actualizar una línea" (Google Sheets).
Mapear Datos a la Hoja de Cálculo: Mapea las variables que contienen los datos extraídos a las columnas correspondientes en la hoja de cálculo.
Créditos de la API: El uso de la API consume créditos, incluso con el plan ilimitado de la plataforma. El consumo se informa en las respuestas de las automatizaciones.
¡Descubre todo esto en Tess AI!
