Configurar BYOK (Business & Enterprise)
Guia completa para usar tus propias claves API (Bring Your Own Key) en planes Business y Enterprise. El consumo depende de las cuotas y facturacion de tu proveedor.
BYOK a nivel de organizacion solo esta disponible en planes Business y Enterprise. Si estas en plan Pro, consulta la guia BYOK Pro (configuracion individual).
Solo los Owners y Admins del workspace pueden configurar claves BYOK. Una vez configuradas, las claves aplican a todos los miembros del workspace automaticamente.
Que es BYOK?
BYOK (Bring Your Own Key) te permite usar tus propias claves API de proveedores de voz (Azure, Google Cloud, ElevenLabs, Deepgram) directamente en goMeetalk. Esto significa:
- Uso segun cuotas del proveedor - pagas directamente en tu cuenta
- Control total de costos en tu propia cuenta
- Tus claves se almacenan cifradas y goMeetalk invoca al proveedor en tu nombre
- Facturacion consolidada con tus otros servicios cloud
Glosario rapido
🏢 Org BYOK
Claves configuradas a nivel workspace. Solo Owner/Admin pueden gestionarlas. Aplican a todos los miembros automaticamente.
👤 Personal BYOK
Claves configuradas por cada usuario. Solo le afectan a el. Disponible en Pro, Business y Enterprise.
Permisos por rol
La configuracion BYOK esta protegida por RBAC. Solo ciertos roles pueden gestionar las claves:
| Accion | Owner | Admin | Manager | Member |
|---|---|---|---|---|
| Agregar claves API | ✓ | ✓ | ✗ | ✗ |
| Eliminar claves API | ✓ | ✓ | ✗ | ✗ |
| Ver claves (enmascaradas) | ✓ | ✓ | ✓ | ✓ |
| Usar BYOK en reuniones | ✓ | ✓ | ✓ | ✓ |
| Ver dashboard de uso | ✓ | ✓ | ✓ | ✗ |
Proveedores soportados
goMeetalk soporta los siguientes proveedores de voz. Puedes configurar uno o varios segun tus necesidades:
Azure Speech Services
STT (Speech-to-Text) + TTS (Text-to-Speech). Requiere region.
- ~$1.00/hora transcripcion (aproximado, consulta pricing oficial)
- ~$4.00/1M caracteres TTS (aproximado, consulta pricing oficial)
- Regiones recomendadas: westeurope, eastus
Google Cloud Speech
STT + TTS. Usa credenciales JSON (Service Account).
- ~$1.44/hora transcripcion (aproximado, consulta pricing oficial)
- ~$4.00/1M caracteres TTS (aproximado, consulta pricing oficial)
- Autenticacion via JSON key file
ElevenLabs
Solo TTS. Voces ultra-realistas con clonacion de voz.
- Starter: desde $5/mes (consulta pricing oficial de ElevenLabs)
- Creator: desde $22/mes (consulta pricing oficial de ElevenLabs)
- Pro: desde $99/mes (consulta pricing oficial de ElevenLabs)
Deepgram
Solo STT. Excelente para transcripcion en tiempo real con baja latencia.
- ~$0.85/hora transcripcion (aproximado, consulta pricing oficial)
- Optimizado para streaming en tiempo real
- API key simple
Paso a paso: Configurar BYOK
Paso 1: Obtener las claves API
Primero necesitas crear una cuenta y obtener las credenciales de cada proveedor que quieras usar:
Por seguridad, crea claves API con los permisos minimos necesarios. No uses claves con acceso completo a tu cuenta cloud.
Azure Speech Services
-
Crear recurso Speech
Ve a Azure Portal → Crear recurso → Busca "Speech" → Crear Speech Service. -
Seleccionar region
Elige una region cercana a tus usuarios (ej: West Europe, East US). Esto afecta la latencia. -
Copiar credenciales
En el recurso creado, ve a "Keys and Endpoint". Copia la Key 1 y la Region.
📱 Captura: Azure Portal - Keys and Endpoint
Google Cloud Speech
-
Crear proyecto
Ve a Google Cloud Console → Crear nuevo proyecto o usar uno existente. -
Habilitar APIs
Activa "Cloud Speech-to-Text API" y "Cloud Text-to-Speech API" en la biblioteca de APIs. -
Crear Service Account
IAM & Admin → Service Accounts → Crear cuenta de servicio con rol "Cloud Speech Client". -
Descargar JSON key
En la cuenta de servicio, ve a Keys → Add Key → Create new key → JSON.
📱 Captura: Google Cloud - Service Account Keys
ElevenLabs
-
Crear cuenta
Registrate en ElevenLabs y elige un plan (Starter minimo). -
Obtener API key
Profile → API Key → Copiar la clave.
📱 Captura: ElevenLabs - Profile API Key
Deepgram
-
Crear cuenta
Registrate en Deepgram. Tienen tier gratuito para empezar. -
Crear API key
Dashboard → API Keys → Create Key. Selecciona permisos "Usage:Read" y "Keys:Read".
📱 Captura: Deepgram - API Keys Dashboard
Paso 2: Agregar claves en goMeetalk
Ahora que tienes las credenciales, vamos a agregarlas a tu workspace de goMeetalk:
Business/Enterprise tienen dos tabs en BYOK: "Org" (claves para todo el workspace) y "Personal" (solo para ti). Esta guia cubre el modo Org.
-
Acceder a configuracion
Ve aapp.gomeetalk.com/profile#byok→ Selecciona el tab 🏢 Org (solo Owner/Admin). -
Seleccionar proveedor
Haz clic en "Agregar proveedor" y selecciona el servicio que quieres configurar. -
Ingresar credenciales
Pega tu API key (y region si aplica). Para Google Cloud, sube el archivo JSON. -
Guardar
Haz clic en "Guardar". Las claves se cifran inmediatamente con AES-256-GCM.
- Tu rol no lo permite → necesitas ser Owner o Admin. Ver roles RBAC
- Tu plan no incluye Org BYOK → actualiza a Business o Enterprise
📱 Captura: goMeetalk - Profile BYOK con tab Org
Paso 3: Probar la conexion
Es importante verificar que las claves funcionan correctamente antes de usarlas en reuniones importantes:
-
Usar boton de test
En la configuracion BYOK, cada proveedor tiene un boton "Probar conexion". Haz clic para verificar. -
Verificar respuesta
Deberas ver un mensaje verde "Conexion exitosa" con la latencia de respuesta. -
Probar en sala
Crea una sala de prueba, activa el motor BYOK y verifica que STT/TTS funcionen correctamente.
Si el test pasa, tu BYOK esta listo. Todos los miembros del workspace podran usar estos motores en sus reuniones automaticamente.
Seguridad de las claves
La seguridad de tus claves API es nuestra prioridad. Asi las protegemos:
🔐 Cifrado AES-256-GCM
Todas las claves se cifran en reposo con AES-256-GCM antes de almacenarse.
👁️ Nunca visibles completas
Las claves nunca se muestran completas. Se expone un fingerprint enmascarado (ej: sk-ab...7x9f).
🛡️ Protegidas por RBAC
Solo Owners y Admins pueden agregar/eliminar claves. Managers solo pueden verlas enmascaradas.
📋 Auditoria de acceso
Las operaciones de gestion BYOK (key_added, key_validated, key_deleted) quedan registradas en los audit logs (Enterprise).
Mejores practicas
- Permisos minimos: Crea claves API solo con los permisos necesarios para speech services.
- Rotacion periodica: Rota tus claves cada 90 dias. Configura recordatorios en tu proveedor.
- No compartir: Nunca compartas claves API por email, Slack u otros canales.
- Monitorear uso: Revisa el dashboard de uso regularmente para detectar anomalias.
- Alertas de gasto: Configura alertas de gasto en cada proveedor para evitar sorpresas.
Dashboard de uso
El dashboard de uso te permite monitorear el consumo de tus claves BYOK en tiempo real:
📊 Captura: Dashboard de uso BYOK - Consumo por proveedor
Metricas disponibles
- Minutos STT: Total de minutos de transcripcion por proveedor
- Caracteres TTS: Total de caracteres sintetizados a voz
- Sesiones: Numero de reuniones que usaron BYOK
Acceso al dashboard
Ve a la seccion de analytics organizacional para consultar metricas de uso. El dashboard muestra el consumo agregado de todo el workspace.
Troubleshooting
Errores comunes (referencia rapida)
| Error | Causa | Solucion |
|---|---|---|
| "No veo tab Org" | Rol o plan insuficiente | Necesitas ser Owner/Admin en plan Business/Enterprise |
| "BYOK_REQUIRED" | No hay key configurada | Configura key en tab Org o Personal para ese motor |
| "Key invalida" | Permisos/creditos/region | Revisa permisos API, creditos disponibles y region |
| "Quota exceeded" | Limite del proveedor | Actualiza plan del proveedor o espera al nuevo ciclo |
Soluciones detalladas
- Verifica que copiaste la clave completa sin espacios
- Asegurate de que la clave no ha expirado o sido revocada
- Para Azure: confirma que la region coincide con tu recurso
- Has superado el limite de tu plan en el proveedor
- Revisa tu dashboard en el proveedor para ver el consumo
- Actualiza tu plan o espera al siguiente ciclo de facturacion
- Elige una region del proveedor mas cercana a tus usuarios
- Considera usar Deepgram para STT (menor latencia)
- Verifica tu conexion a internet
Si el problema persiste, contacta a [email protected] con el mensaje de error exacto y el proveedor afectado.