API de Transcriptly.AI
Lleva las conversaciones de tu negocio a tus propios sistemas. La API de Transcriptly.AI permite iniciar llamadas grabadas, consultar transcripciones y resúmenes, y aprovechar los compromisos y fechas que la IA detecta en cada conversación.
- URL base
https://api.transcriptly.ai/api/v1- Formato
- REST con JSON
- Autenticación
- Token de acceso (Bearer)
- Acceso
- Socios y clientes habilitados
- Actualizado
- 5 de noviembre de 2026
Introducción
#Qué puedes construir
Transcriptly.AI convierte llamadas, reuniones y audios en información accionable. Con la API, tu aplicación usa las mismas capacidades que la app y la plataforma web, con la identidad y el plan de una cuenta autorizada.
| Capacidad | Para qué sirve |
|---|---|
| Llamadas grabadas | Iniciar una llamada desde tu sistema y obtener su grabación sin instalar nada en el teléfono. |
| Transcripción y resumen | Texto completo de la conversación, resumen, sentimiento y palabras clave. |
| Compromisos y fechas | Tareas acordadas y citas detectadas en la conversación, listas para tu agenda o CRM. |
| Contactos | Vincular cada conversación con el cliente correspondiente. |
| Calendario | Enviar las citas detectadas al calendario conectado del usuario. |
Introducción
#Cómo funciona
- AutenticaTu integración obtiene un token de acceso con las credenciales de una cuenta habilitada.
- Inicia o envíaInicia una llamada grabada o registra la información de tu cliente.
- Consulta el estadoEl procesamiento es asíncrono: consulta el estado hasta que el resultado esté listo.
- Usa el resultadoLee la transcripción, el resumen, los compromisos y las fechas, y llévalos a tus sistemas.
Seguridad
#Acceso y autenticaciónDisponible
El acceso a la API se habilita por solicitud. Al aprobar tu integración, el equipo de Transcriptly.AI te entrega la guía técnica de tu caso de uso y una cuenta de pruebas.
- Cada solicitud protegida envía el token en el encabezado
Authorization: Bearer <access_token>. - Los tokens vencen y pueden renovarse; al terminar, cierra la sesión.
- La integración actúa con la identidad, el plan y los permisos de la cuenta autorizada: nunca puede leer datos de otra cuenta.
curl -sS "https://api.transcriptly.ai/api/v1/contacts" \
-H "Authorization: Bearer $TRANSCRIPTLY_TOKEN"Contrato
#Convenciones
La API usa JSON sobre HTTPS y códigos de estado HTTP estándar. Las guías de cada integración documentan los campos de entrada y salida de cada operación.
| Tema | Convención |
|---|---|
| Identificadores | Cada recurso tiene un identificador estable para enlazarlo con tus sistemas. |
| Fechas | ISO 8601 en UTC, por ejemplo 2026-11-05T14:02:11Z. |
| Teléfonos | Formato internacional E.164, por ejemplo +573001234567. |
| Compatibilidad | Usa solo los campos documentados en tu guía. Pueden aparecer campos nuevos sin previo aviso. |
Contrato
#Manejo de errores
Cada error incluye un código y un identificador de solicitud. Programa contra el estado HTTP y el código de error, nunca contra el texto del mensaje.
| HTTP | Significado | Qué hacer |
|---|---|---|
| 400 | Solicitud inválida | Corrige los datos enviados. No reintentes igual. |
| 401 | Sesión ausente o vencida | Renueva el token o vuelve a iniciar sesión. |
| 403 | Operación no habilitada para la cuenta | Verifica la habilitación con Transcriptly.AI. |
| 404 | Recurso no encontrado | Revisa el identificador. |
| 409 | Conflicto de estado | Espera a que termine la operación en curso y reintenta. |
| 429 | Demasiadas solicitudes | Espera antes de reintentar. |
| 5xx | Error temporal | Reintenta con espera progresiva. |
Operación
#Buenas prácticas
- Consulta estados con intervalos de varios segundos y detente al recibir un estado final.
- Reintenta solo errores temporales, con espera progresiva.
- Conserva el identificador de solicitud de los errores para agilizar el soporte.
- Mantén los tokens y los datos de clientes en tu servidor, nunca en el navegador o la app.
Seguridad
#Privacidad y responsabilidades
- Los datos de cada cuenta están aislados y solo los consulta un token de esa cuenta.
- Las grabaciones se almacenan de forma privada y se cifran en tránsito.
- Toda llamada grabada exige registrar el consentimiento correspondiente.
Soporte
#Acceso y soporte
Para habilitar una integración o reportar un incidente, escribe a admin@transcriptly.ai con tu caso de uso o con el identificador de solicitud, el endpoint y la hora aproximada (UTC). Nunca envíes tokens, contraseñas ni códigos de verificación.
Socios habilitados: API de llamadas para agendamiento (acceso restringido).