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 ejecución de agentes, procesamiento de lenguaje natural y otras tareas de IA. Esto hace posible integrar 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 escolar 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. Luego, la transcripción es procesada por un agente en Tess AI entrenado para generar el acta ya formateada.
Novedades de la API
Tess AI está en desarrollo constante y se agregan nuevas funciones regularmente. Estate atento a las novedades en la documentación de la API.
Accediendo a la API
Existen dos formas 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 úsalo 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.
Disparador: Elige el disparador "Nueva fila en la hoja de cálculo" (Google Sheets).
Seleccionar Hoja: Selecciona la hoja y la pestaña que contienen los feedbacks.
Acción: Ejecutar Template: Añade la acción "Ejecutar Template" (Tess AI App).
Seleccionar Template: Elige el template de clasificación de feedbacks.
Mapear Campos: Mapea los campos "feedback" y "estrellas" de la hoja de cálculo a los parámetros correspondientes del template.
Webhook Callback URL (para segundo Zap): Configura el "Webhook Callback URL" para un segundo Zap que va a procesar la respuesta.
Segundo Zap - Disparador: Crea un segundo Zap con el disparador "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 Fila: Añade la acción "Actualizar Fila en la hoja de cálculo" (Google Sheets).
Mapear ID de la Fila: Mapea el ID de la fila para asegurarte de que el registro correcto se actualice.
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 procesos lentos.
Integración con Make (paso a paso)
Nuevo Escenario: Crea un nuevo escenario en Make.
Disparador: Añade el disparador "Observar cambios en la hoja de cálculo" (Google Sheets).
Seleccionar Hoja: Selecciona la hoja y la pestaña que contienen los feedbacks.
Módulo HTTP (POST): Añade el módulo "HTTP" y configura el método como POST.
URL de Ejecución: Configura la URL de ejecución del template (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, pon 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 guardar el ID de la ejecución que devuelve la API.
Módulo Repeater (Polling): Añade un módulo "Repeater" para hacer polling.
Intervalo de Polling: Configura el intervalo de tiempo entre las comprobaciones 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 Comprobación de Estado: Configura la URL de comprobación de estado (de la documentación de la API), incluyendo el ID de la ejecución guardado antes.
Cabecera Authorization (GET): Añade la cabecera "Authorization" con el valor "Bearer <tu_token>".
Condición de Parada del Repeater: Configura el repeater para que pare 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 fila" (Google Sheets).
Mapear Datos para 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 muestra en las respuestas de las automatizaciones.
Descubre todo esto en Tess AI!
