Esta guía explica cómo configurar y utilizar la funcionalidad de Texto a Voz (TTS) con ElevenLabs en nuestra plataforma de automatización de WhatsApp.
¿Qué es? #
Esta integración permite convertir texto escrito en Notas de Voz de WhatsApp que suenan naturales y humanas. El sistema utiliza la inteligencia artificial de ElevenLabs para generar el audio y lo envía automáticamente como si fuera grabado desde el micrófono (PTT – Push to Talk).
Configuración #
Para utilizar esta funcionalidad, necesitas configurar tu API Key de ElevenLabs en la configuración del dispositivo (Slot).
- Ve a tu panel de control de ElevenLabs y obtén tu API Key.
- En el dashboard de tu agencia, abre la configuración del Slot de WhatsApp.
- Ingresa tu ElevenLabs API Key.
- Selecciona una Voz por Defecto de la lista (el sistema cargará las voces disponibles en tu cuenta).
- Guarda los cambios.
Cómo Usar (Comandos) #
Puedes generar notas de voz usando el comando especial #voice en cualquier mensaje saliente (desde GoHighLevel, n8n o respuestas automáticas).
Sintaxis Básica #
#voice||Tu mensaje aquí
Esto usará la voz configurada por defecto en el slot.
Sintaxis Avanzada (Voz Específica) #
Si deseas usar una voz diferente para un mensaje específico, puedes incluir el ID de la voz:
#voice|ID_DE_LA_VOZ|Tu mensaje aquí
Ejemplo: #voice|21m00Tcm4TlvDq8ikWAM|Hola, esto es una prueba.
Comportamiento del Sistema #
- Detección: El sistema detecta automáticamente cualquier mensaje que empiece con
#voice. - Generación: Envía el texto a ElevenLabs para generar el audio.
- Envío: El audio se convierte y se envía al usuario final como una Nota de Voz (onda verde) en WhatsApp.
NOTE
Si no configuras una API Key en el slot, el sistema intentará usar la configuración global de la agencia (si existe). Si no hay ninguna configuración, el comando fallará y devolverá un error.
Solución de Problemas #
| Problema | Causa Probable | Solución |
|---|---|---|
| El mensaje no se envía | API Key inválida o sin créditos | Verifica tu cuenta de ElevenLabs. |
| Se envía como texto | Error en la sintaxis | Asegúrate de usar el formato correcto(‘#voice|…’) |
| Audio vacío | Texto muy corto o vacío | Escribe un mensaje válido después de los separadores. |
Esta documentación está diseñada para administradores y usuarios de la plataforma.