> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/ligacao-modulos/ligacoes.md).

# Ligações

O módulo **Ligações** é o ponto de partida de uma chamada de voz dentro do fluxo: ele toca um áudio para o cliente assim que a ligação chega até ali, e pode aguardar o cliente digitar algo no teclado do telefone.

### 🗂️ Como acessar

1. No menu lateral do Hyperflow Integrações, acesse **Gerenciamento de aplicativos > Fluxos**.
2. Abra o fluxo desejado (ou crie um novo).
3. Na paleta à direita, expanda a categoria **Ligações**.
4. Arraste o módulo **Ligações** para o canvas.

***

### 🔍 Conhecendo o módulo

#### 1️⃣ Reproduzir áudio

Ao abrir o módulo, você escolhe qual áudio o cliente vai ouvir assim que a ligação chegar até este ponto do fluxo.

| Campo                   | O que preencher                                                                          |
| ----------------------- | ---------------------------------------------------------------------------------------- |
| **Nome do nó**          | Nome para identificar este módulo dentro do fluxo                                        |
| **Origem do áudio**     | Escolha **Biblioteca de áudios** para usar um arquivo já enviado                         |
| **Áudio da biblioteca** | Selecione o áudio que será reproduzido para o cliente                                    |
| **Descrição**           | Texto livre só para você lembrar o que aquele áudio fala, sem precisar tocar ele de novo |

{% hint style="info" %}
A opção **Texto para fala (TTS)**, que geraria o áudio a partir de um texto digitado, aparece na tela marcada como "Em breve". Por enquanto, use sempre um áudio da biblioteca.
{% endhint %}

**🎯 Propósito**

Dar as boas-vindas ao cliente ou passar uma instrução assim que a ligação chega neste ponto do fluxo.

**✅ Como fazer na tela**

1. Em **Origem do áudio**, deixe selecionado **Biblioteca de áudios**.
2. Em **Áudio da biblioteca**, escolha o arquivo desejado.
3. Preencha a **Descrição** para lembrar o conteúdo do áudio depois.

**📌 Resultado esperado**

Assim que a chamada chegar neste módulo, o cliente ouve o áudio escolhido.

***

#### 2️⃣ Coletar dígito

Depois de tocar o áudio, o módulo pode esperar o cliente apertar teclas do telefone. Ative o interruptor **Coletar dígito** e escolha um dos dois modos abaixo.

**Dígito único.** Cada tecla configurada abre uma saída própria no módulo, como em uma URA clássica ("aperte 1 para Suporte, 2 para Financeiro").

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FuBfgx6ce1IaGpcrPnS1i%2Fimage.png?alt=media&amp;token=58a8cdf9-c35e-4497-b127-09e3a3462807" alt=""><figcaption><p>Imagem 1 - Interruptor "Coletar dígito" ativado, com os dois modos "Dígito único" e "Múltiplos dígitos" visíveis</p></figcaption></figure>

**🎯 Propósito**

Direcionar o fluxo para caminhos diferentes de acordo com a tecla que o cliente aperta.

**✅ Como fazer na tela**

1. Selecione o modo **Dígito único**.
2. Clique em **+ Adicionar dígito** para cada opção que quiser oferecer.
3. Dê um nome para cada opção. Esse nome aparece como o rótulo da saída no fluxo.

**📌 Resultado esperado**

O módulo passa a ter uma saída para cada dígito cadastrado, além de uma saída fixa de **Sem resposta**, usada quando o cliente não digita nada.

**Múltiplos dígitos.** Em vez de escolher uma opção, o cliente digita uma sequência inteira (como um CPF ou telefone), que é salva em uma variável do fluxo.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2F88RfsoPRAfFJN84YHanq%2Fimage.png?alt=media&amp;token=2e955681-13f2-4735-81c2-ba9b5353d991" alt=""><figcaption><p>Imagem 2 - Modo "Múltiplos dígitos" com o campo "Salvar dígitos na variável" preenchido</p></figcaption></figure>

**🎯 Propósito**

Coletar uma informação numérica completa digitada pelo cliente durante a ligação.

**✅ Como fazer na tela**

1. Selecione o modo **Múltiplos dígitos**.
2. Em **Salvar dígitos na variável**, dê um nome para a variável que vai guardar o valor digitado. Campo obrigatório.
3. Defina o **mínimo** e o **máximo** de dígitos aceitos.
4. Escolha a **Tecla de finalização**, que indica como o cliente confirma que terminou de digitar.

**📌 Resultado esperado**

Depois que o cliente termina de digitar a sequência, o valor fica disponível na variável escolhida para uso nos próximos módulos do fluxo. Diferente do modo Dígito único, aqui o módulo tem apenas uma saída.

***

#### 3️⃣ Tempo máximo sem resposta

Define o que acontece se o cliente não apertar nenhuma tecla.

**🎯 Propósito**

Repetir o áudio automaticamente algumas vezes antes de desistir da resposta do cliente.

**✅ Como fazer na tela**

1. Em **Máx. tentativas**, escolha quantas vezes o áudio repete, de 1 a 3.
2. Em **Intervalo entre tentativas**, defina quantos segundos esperar antes de tentar de novo.

**📌 Resultado esperado**

Depois de esgotadas as tentativas sem resposta do cliente, o fluxo segue pela saída de **Sem resposta**.

***

### 💡 Dicas úteis

* O módulo Ligações fica na categoria **Ligações** da paleta, junto com **Transferir URA**, **Posição na Fila** e **Encerrar Ligação**.
* Use o modo **Dígito único** para menus de opções (URA) e o modo **Múltiplos dígitos** quando precisar coletar um número completo do cliente, como CPF ou telefone.

***

### 🧩 Caso de uso

Uma loja quer que o cliente escolha entre Suporte e Financeiro ao ligar. No módulo **Ligações**, configure um áudio de saudação ("Bem-vindo à Loja X. Para Suporte, aperte 1. Para Financeiro, aperte 2.") e ative **Coletar dígito** no modo **Dígito único**, criando as opções "Suporte" e "Financeiro". Cada opção é ligada a um módulo **Transferir URA** diferente, um apontando para o departamento de Suporte e outro para o de Financeiro.

***

### 📌 Resumo

* O módulo **Ligações** toca um áudio para o cliente assim que a chamada chega até ele.
* Pode coletar dígitos em dois modos: **Dígito único** (uma saída por tecla) ou **Múltiplos dígitos** (uma sequência inteira salva em variável, com uma única saída).
* Tem uma configuração de tentativas e intervalo para quando o cliente não responde.
* A opção de Texto para fala (TTS) ainda não está disponível: use sempre áudio da biblioteca.
