> ## Documentation Index
> Fetch the complete documentation index at: https://help.goghl.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Texto para Voz (Geração de Áudio) com ElevenLabs

## O Que Faz[​](#o-que-faz "Link direto para O Que Faz")

O recurso de **Texto para Voz** converte automaticamente mensagens de texto em notas de voz com som natural, enviadas como mensagens de áudio do WhatsApp dentro das conversas do seu CRM usando a **API da ElevenLabs**. Isso permite que você **envie mensagens de voz a partir de fluxos de trabalho de automação** - sem precisar gravar áudio manualmente.

Você pode escolher entre uma grande variedade de vozes de IA e até clonar vozes personalizadas usando a ElevenLabs. É perfeito para criar respostas de áudio personalizadas em escala.

***

## Como Ativar Texto para Voz[​](#como-ativar-texto-para-voz "Link direto para Como Ativar Texto para Voz")

### Passos:[​](#passos "Link direto para Passos:")

<Steps>
  <Step>
    Vá até suas localizações e procure o **item de menu do WhatsApp** na barra lateral.
  </Step>

  <Step>
    Depois de clicar no item de menu do WhatsApp, vá em **Configurações**.
  </Step>

  <Step>
    Role para baixo até a seção **Texto para Voz (Geração de Áudio)**.
  </Step>

  <Step>
    Insira sua **Chave de API da ElevenLabs**, ative **Habilitar Texto para Voz** e clique em **Salvar**.
  </Step>
</Steps>

***

## Como Usar Texto para Voz[​](#como-usar-texto-para-voz "Link direto para Como Usar Texto para Voz")

Para enviar uma nota de voz, use este formato em qualquer campo de mensagem do WhatsApp (mensagens manuais, fluxos de trabalho ou automações):

### Formato da Mensagem:[​](#formato-da-mensagem "Link direto para Formato da Mensagem:")

```text theme={null}
[AUDIO] [voice_id] Sua mensagem de texto aqui
```

### Exemplo:[​](#exemplo "Link direto para Exemplo:")

```text theme={null}
[AUDIO] [XrExE9yKIg1WjnnlVkGX] Na antiga terra de Eldoria, onde os céus cintilavam e as florestas sussurravam segredos ao vento, vivia um dragão chamado Zephyros.
```

### Detalhamento do Formato:[​](#detalhamento-do-formato "Link direto para Detalhamento do Formato:")

* `[AUDIO]` - Palavra-chave de acionamento (obrigatória)
* `[voice_id]` - Seu Voice ID da ElevenLabs (obrigatório)
* Texto após o Voice ID - A mensagem que será convertida em voz

### Onde Você Pode Usar:[​](#onde-você-pode-usar "Link direto para Onde Você Pode Usar:")

* Mensagens manuais em conversas
* Respostas automatizadas de fluxos de trabalho
* Mensagens baseadas em gatilhos
* Transmissões agendadas
* Valores e variáveis personalizados

### Usando Variáveis:[​](#usando-variáveis "Link direto para Usando Variáveis:")

Você também pode combiná-lo com campos personalizados:

```text theme={null}
[AUDIO] [XrExE9yKIg1WjnnlVkGX] Olá \{\{contact.first_name\}\}, seu agendamento está confirmado para \{\{contact.appointment_date\}\}.
```

***

## Como Obter Sua Chave de API da ElevenLabs[​](#como-obter-sua-chave-de-api-da-elevenlabs "Link direto para Como Obter Sua Chave de API da ElevenLabs")

<Steps>
  <Step>
    Acesse a [ElevenLabs](https://elevenlabs.io/).
  </Step>

  <Step>
    Faça login ou crie uma conta.
  </Step>

  <Step>
    Navegue até as suas [Configurações de Perfil](https://elevenlabs.io/app/settings/api-keys).
  </Step>

  <Step>
    Clique em **Create API Key**.
  </Step>

  <Step title="Importante">
    Ao criar a chave de API, certifique-se de habilitar estas permissões:

    * **Text-to-Speech**
    * **Voices** (para acessar a biblioteca de vozes)
  </Step>

  <Step>
    Copie a chave gerada.
  </Step>

  <Step>
    Cole-a nas configurações de **Texto para Voz**.
  </Step>
</Steps>

<Warning>
  Certifique-se de habilitar as permissões de **Text-to-Speech** e **Voices** ao criar sua chave de API da ElevenLabs, caso contrário o recurso não funcionará.
</Warning>

***

## Como Encontrar Voice IDs[​](#como-encontrar-voice-ids "Link direto para Como Encontrar Voice IDs")

Cada voz na ElevenLabs tem um Voice ID único que você precisará usar nas suas mensagens.

### Passos para Obter um Voice ID:[​](#passos-para-obter-um-voice-id "Link direto para Passos para Obter um Voice ID:")

<Steps>
  <Step>
    Acesse o seu [Painel da ElevenLabs](https://elevenlabs.io/app/voice-library).
  </Step>

  <Step>
    Navegue pela **Biblioteca de Vozes** ou use suas vozes clonadas personalizadas.
  </Step>

  <Step>
    Clique em qualquer voz que você queira usar.
  </Step>

  <Step>
    Copie o **Voice ID** (ele se parece com: `XrExE9yKIg1WjnnlVkGX`).
  </Step>

  <Step>
    Use esse Voice ID no seu formato de mensagem (veja abaixo).
  </Step>
</Steps>

<Check>
  A ElevenLabs oferece centenas de vozes prontas em vários idiomas. Você também pode clonar sua própria voz para manter a consistência da marca.
</Check>

***

## Perguntas Frequentes[​](#perguntas-frequentes "Link direto para Perguntas Frequentes")

<AccordionGroup>
  <Accordion title="Isso consome muitos créditos da ElevenLabs?">
    O uso depende do tamanho do seu texto. A ElevenLabs cobra com base nos caracteres convertidos. O plano gratuito inclui um número limitado de caracteres por mês, enquanto os planos pagos oferecem limites maiores.
  </Accordion>

  <Accordion title="Posso usar isso em fluxos de trabalho de automação?">
    Sim! Você pode usar o formato \[AUDIO] \[voice\_id] em qualquer campo de mensagem dentro de fluxos de trabalho, gatilhos ou automações.
  </Accordion>

  <Accordion title="Posso usar minha própria voz clonada?">
    Sim. Se você criou um clone de voz personalizado na ElevenLabs, basta copiar o ID dessa voz e usá-lo no formato da mensagem.
  </Accordion>

  <Accordion title="Preciso de uma conta paga da ElevenLabs?">
    Não, o recurso funciona tanto com contas gratuitas quanto pagas da ElevenLabs. No entanto, os planos pagos oferecem mais caracteres e processamento mais rápido.
  </Accordion>

  <Accordion title="O que acontece se eu usar o Voice ID errado?">
    Se o Voice ID for inválido ou não estiver acessível com a sua chave de API, a mensagem falhará no envio ou será enviada como texto.
  </Accordion>

  <Accordion title="Posso usar vozes diferentes para mensagens diferentes?">
    Sim! Basta usar Voice IDs diferentes para cada mensagem. Você pode trocar de voz conforme necessário.
  </Accordion>

  <Accordion title="Quais idiomas são suportados?">
    A ElevenLabs suporta vários idiomas. Consulte a Biblioteca de Vozes da ElevenLabs para ver os idiomas e vozes disponíveis.
  </Accordion>

  <Accordion title="Existe um limite de tamanho para a mensagem?">
    As notas de voz do WhatsApp têm um limite prático. Recomendamos manter as mensagens abaixo de 2-3 minutos (aproximadamente 300-450 palavras) para obter os melhores resultados.
  </Accordion>
</AccordionGroup>

***

## Suporte[​](#suporte "Link direto para Suporte")

Se você precisar de ajuda com a configuração ou integração:

* Suporte no WhatsApp: [Conversar no WhatsApp](https://wa.me/+12267248710?text=Hi%2C%20I%20need%20help%20with%20Text-to-Speech%20%28Audio%20Generation%29%20with%20ElevenLabs.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)
