Configura la voz con ElevenLabs
La integración de ElevenLabs permite configurar generación de voz. Las funciones de voz TTS están habilitadas para Pro y Business; comprueba además el estado de tu proveedor.
Qué necesitas
Una cuenta de ElevenLabs, una clave válida, el identificador de una voz disponible para esa cuenta y capacidad de uso en el proveedor. La suscripción a Synvaxis no convierte una clave de ElevenLabs sin saldo en una clave operativa.
Conectar
- Abre Integraciones y selecciona ElevenLabs.
- Introduce la clave API y el Voice ID solicitados.
- Guarda y confirma la conexión.
- Revisa las opciones de voz en la configuración del asistente.
- Prueba con una frase breve en un canal compatible.
Elegir la voz
Usa una voz autorizada para tu negocio y el idioma de tus clientes. El Voice ID debe corresponder a una voz a la que tu cuenta tenga acceso. Un nombre comercial de voz no sustituye ese identificador.
Si no se genera el audio
Comprueba plan, clave, cuota y disponibilidad de la voz. Si el audio se genera pero no se entrega, revisa el canal y el estado del medio. La generación de voz y la entrega del archivo son pasos distintos.
Costos y límites
Consulta las condiciones vigentes de ElevenLabs en tu cuenta del proveedor. Los límites y cargos del servicio externo no se consultan como si fueran créditos de Synvaxis.
Llamadas: conexión automática
- En Integraciones → ElevenLabs, elige Llamadas y pega tu API key.
- Elige una voz. Synvaxis crea el agente y su herramienta para continuar por WhatsApp.
- Selecciona un número SIP o Twilio que ya esté importado en ElevenLabs. La API key por sí sola no crea una línea telefónica.
- Synvaxis crea un webhook HMAC, guarda su secreto cifrado, activa los reintentos y lo vincula al agente para recibir transcripciones y fallos al iniciar llamadas.
La clave necesita acceso de lectura a la cuenta y las voces, y permisos para consultar y administrar agentes, herramientas, números y webhooks. No compartas la clave ni el secreto en el chat con clientes.
Si necesitas configurarlo manualmente
- Abre Webhooks en ElevenLabs y crea un webhook con autenticación HMAC.
- Usa exactamente
https://app.synvaxis.com/api/webhook/voice-call-endedcomo URL. - Copia el secreto que empieza por
wsec_y pégalo en Configuración manual dentro de Synvaxis. - Pulsa Verificar. Synvaxis comprueba la URL, habilita los reintentos y vincula los eventos
transcriptycall_initiation_failureal agente. Necesita permisos para completar esa vinculación. - Si el webhook fue deshabilitado por fallos, vuelve a conectar automáticamente. Si hay varios webhooks con esa URL y no sabes qué secreto corresponde a cada uno, usa la conexión automática para crear uno identificado.
Estados y recuperación
Una llamada solicitada todavía no significa que el cliente haya contestado. El chat muestra el resultado de esa llamada concreta: finalizada, ocupada, sin respuesta o pendiente de confirmar. Las llamadas son eventos internos; no son mensajes enviados por WhatsApp.
Si falta el webhook, el proceso periódico consulta a ElevenLabs para recuperar el resultado, sin volver a llamar. Si el proveedor sigue sin confirmar, se muestra esa incertidumbre.
Las llamadas automáticas respetan la política de recuperación configurada, el acceso al plan de llamadas y el horario de 09:00 a antes de las 20:00, estimado por el prefijo del teléfono. Esa estimación no determina la ubicación real del cliente. Un bot pausado o actividad nueva antes del inicio cancela la llamada automática. El botón de llamada del operador inicia una llamada manual.
El seguimiento por WhatsApp solo se confirma cuando Meta acepta el envío. Si terminó la ventana de respuesta, el asistente pide al cliente que escriba al negocio para continuar.
Referencia: creación de webhooks por API y eventos posteriores a la llamada.