---
title: Ligação por IA
slug: helper/ligacao-por-ia
createdAt: 2026-11-19T14:26:40.280Z
---

A Ligação por IA é o atendimento **por voz feito por uma IA**: o assistente atende a ligação, entende o que a pessoa precisa e transfere para a fila certa, com um resumo para o atendente.

## Os assistentes de voz

O menu **Ligação por IA** lista os assistentes de voz do workspace. Cada cartão mostra:

|                    | o que é                                                                                                                                 |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| Nome               | como o assistente aparece para a equipe                                                                                                 |
| Ligada / Desligada | se o assistente atende as ligações                                                                                                      |
| Canal              | a conexão de WhatsApp que o assistente atende, pelo ID do canal da tela [Canais](https://docs.run2biz.com/helper/canais) (ou Sem canal) |
| Versão             | a versão publicada do fluxo da ligação (ou Sem fluxo da ligação)                                                                        |

## Criar, renomear e excluir

- **Criar:** clique em **Novo assistente** e dê um nome. O assistente nasce **desligado** e **sem fluxo da ligação**.
- **Renomear:** clique no nome do assistente no cartão, escreva o novo nome e tecle *Enter*.
- **Excluir:** clique na lixeira e **digite o nome** do assistente para confirmar. A exclusão não pode ser desfeita.

Dois assistentes de voz do mesmo workspace não podem ter o mesmo nome (maiúsculas e minúsculas contam como iguais).

## Ligar e desligar

O botão ▶ / ❚❚ do cartão liga e desliga o assistente. **Para ligar, o assistente precisa do canal e da frase de recusa**, os dois na configuração; enquanto faltar um deles, o botão fica apagado e a dica diz o que falta. O som de espera é opcional: sem ele, a espera fica em silêncio. Desligar é sempre possível.

## A configuração

A engrenagem do cartão abre a configuração do assistente. Os campos já vêm com os valores padrão; clique em **Salvar** para gravar. Número apagado volta ao padrão, que aparece em cinza no campo vazio. Se algum valor não servir, nada é gravado e o erro aparece embaixo do campo.

| Campo                                    | O que é                                                                                                                                                                                                                                                                                                                                                         |
| ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Canal do WhatsApp                        | o número que o assistente atende. A lista mostra os canais do WhatsApp da Meta ligados; cada canal fica em um assistente só                                                                                                                                                                                                                                     |
| Voz                                      | a voz da IA na ligação. Vale a partir da próxima ligação                                                                                                                                                                                                                                                                                                        |
| Idioma inicial                           | o idioma em que estão escritas a frase de abertura e as outras frases ditas antes de a IA saber o idioma de quem liga (português de início). A IA lê os números delas nesse idioma, sem traduzir nada, e fala nele enquanto quem liga não disser nada ou disser algo sem idioma claro; depois do Entendimento, vale o idioma de quem liga. Veja Números, abaixo |
| Avisos no chat                           | se o chat do WhatsApp recebe, durante a ligação, os textos automáticos da fila e o aviso de fim da chamada, com a duração e o protocolo (desligado de início)                                                                                                                                                                                                   |
| Transcrever a conversa com o atendente   | se o que quem liga e o atendente dizem, depois que o atendente entra na chamada, vira uma nota na conversa ao fim da ligação (desligado de início). Usa a conexão STTS em tempo real e conta nos minutos de transcrição: são dois fluxos, um para cada voz. Veja Transcrição da conversa com o atendente, abaixo                                                |
| Confiança mínima                         | de 1 a 10, o quanto a IA precisa ter certeza do que entendeu para seguir (7 de início)                                                                                                                                                                                                                                                                          |
| Tentativas de esclarecimento             | quantas vezes a IA pede para a pessoa explicar de novo antes do fallback (2)                                                                                                                                                                                                                                                                                    |
| Tempos e limites                         | tempo máximo de conversa (90 s), máximo de turnos (6), tempo de espera com a IA (300 s) e ligações simultâneas (5). As simultâneas contam também as ligações que esperam a fila; acima delas, a ligação nova é recusada (veja Ligação recusada, abaixo)                                                                                                         |
| Fim da ligação                           | tempo para voltar a ligar (60 s) e silêncio que conta como queda (5 s). Veja Quando quem liga sai da linha, abaixo                                                                                                                                                                                                                                              |
| Som de espera                            | o áudio que toca, repetindo, enquanto a ligação espera a fila: mp3, wav, ogg ou m4a, até 2 MB. É gravado assim que você o envia. Sem som, a espera fica em silêncio                                                                                                                                                                                             |
| Frase durante a espera                   | o que a IA fala, no idioma da conversa, enquanto a ligação espera a fila. O som de espera pausa durante a frase e volta de onde parou. Vazia, nada é dito                                                                                                                                                                                                       |
| De quanto em quanto tempo a frase é dita | em segundos (60 de início). A primeira vez, esse tempo depois do começo da espera; as seguintes, esse tempo depois do fim da anterior                                                                                                                                                                                                                           |
| Frase de quando o fallback também recusa | o que a IA fala, no idioma da conversa, quando nem a fila de fallback aceita a ligação                                                                                                                                                                                                                                                                          |
| Frase de quando a IA não entende         | o que a IA fala, no idioma da conversa, antes de transferir quando não entendeu a tempo. Vem com "Desculpe, não consegui entender. Vou transferir você para um atendente."; apagada, volta a ela                                                                                                                                                                |

Com o assistente ligado, não dá para tirar o canal nem a frase de recusa: desligue antes. O som de espera pode ser removido a qualquer momento.

O modelo da IA não fica aqui: é um só para o workspace, no campo **Modelo da Ligação por IA** da conexão **STTS** em Administração › Integrações. O padrão é o `gpt-realtime-2.1`; o `gpt-realtime-2.1-mini` é mais barato.

## O fluxo da ligação

O botão **Fluxo da Ligação** do cartão abre o editor do assistente. É nele que você monta, em blocos, como a IA conduz a ligação. Um assistente novo abre só com o **Início**; o fluxo da ligação passa a valer quando você o publica (**Salvar › Publicar nova versão**).

| Bloco        | O que a IA faz                                                | O que você configura                                                                                                                                                                                                                  |
| ------------ | ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Início       | atende e fala a frase de abertura, como está escrita          | a frase de abertura                                                                                                                                                                                                                   |
| Frase        | fala uma frase ou faz uma pergunta                            | o texto; com Guardar a resposta ligado, ela espera a resposta, repete o que anotou e pede um "sim" (com "não", pede para soletrar; sem confirmação, a nota marca "não confirmado") e a coloca na nota do atendente com o Nome na nota |
| Entendimento | entende o que a pessoa precisa e passa a falar no idioma dela | se quiser, a frase depois de entender (ex.: "Só um momento, por favor."); vazia, a IA não diz nada nesse ponto                                                                                                                        |
| Confirmação  | confirma o que entendeu                                       | nada: a primeira seta é o "sim" e a segunda, o "não" (o "não" pode ir para qualquer bloco)                                                                                                                                            |
| Transferir   | escolhe a fila e transfere a ligação                          | as filas que ela pode escolher, cada uma com os assuntos que vão para ela e, se quiser, o que é urgente ali; a fila de fallback; e, se quiser, a frase ao transferir                                                                  |

O Transferir oferece só as filas de atendimento ativas. A fila de fallback recebe tudo o que não tem fila na lista. A ligação urgente vai para o topo da fila. O que é urgente em cada fila também vale já no Entendimento: veja Relato urgente, abaixo.

Ao publicar, o fluxo da ligação é conferido. Se algo estiver faltando, nada é publicado: uma faixa no topo lista o que corrigir, e cada erro aparece também ao lado do campo, com o bloco marcado. Não publica:

- fluxo da ligação sem Início, ou com mais de um;
- campo obrigatório vazio;
- fila que não existe ou está inativa;
- bloco sem ligação: que nenhuma seta alcança a partir do Início, ou com a saída solta;
- seta saindo do Transferir, que encerra o fluxo da ligação.

## Exportar e importar

Para levar o assistente a outro workspace ou ambiente, use o menu ⋯ do editor:

- **Exportar JSON** baixa um arquivo com o fluxo da ligação que está na tela, a configuração do assistente (voz, tempos, limites e frases), o som de espera, as filas do Transferir e o fluxo de texto do assistente dono do número. Se a Ligação por IA ainda não tem número, o editor pergunta qual assistente de texto vai junto.
- **Importar JSON** mostra antes o que vai ser criado e aplicado. Ao confirmar:
  - a fila que não existe neste workspace é criada com a configuração que veio no arquivo (horário, protocolo, avaliação e mensagens), sem a equipe; a que já existe é usada como está;
  - a configuração e o som de espera são aplicados a este assistente;
  - o fluxo de texto vira um assistente de texto novo, com o nome que veio no arquivo (se o nome já existe, ganha um número), com o fluxo publicado; as conexões chegam desligadas, à espera do token;
  - o fluxo da ligação abre no editor sem ser publicado: revise e publique.

O número não vem no arquivo: ele é configurado no destino, na engrenagem do assistente. O ligar/desligar também continua o deste workspace.

## Na ligação

Com o assistente ligado, a IA atende as ligações do canal e segue o fluxo da ligação publicado:

- **Só encaminha:** a IA não orienta nem responde sobre o problema da pessoa (saúde, jurídico, financeiro, técnico ou qualquer outro), nem com primeiros socorros, mesmo que a pessoa peça ou insista: diz que um atendente vai ajudar e segue o fluxo até a transferência.
- **Idioma:** a frase de abertura sai como está escrita. Depois do Entendimento, a IA fala no idioma da pessoa (português, espanhol ou inglês), pelas palavras que ela usa, e não pelo sotaque. Quando as palavras cabem em mais de um idioma (como "roubo de celular", quase igual em espanhol), vale o idioma da frase de abertura; ela só troca se a pessoa falar claramente outro. Uma saudação ou palavra solta ("alô", "hello", "hola") não basta para trocar. As frases do fluxo da ligação, a frase de recusa, a de quando a IA não entende e a frase durante a espera podem ser escritas em qualquer desses idiomas: se estiverem no idioma da conversa, a IA as fala como estão; se não, fala a tradução.
- **Números:** a IA fala os números no idioma da frase. Até 4 algarismos juntos são lidos como um número só ("911" → "novecentos e onze"); algarismos separados por hífen, vírgula ou espaço são lidos um a um ("9-1-1" → "nove, um, um"), e os números de 5 ou mais algarismos, como o protocolo, também. Valores ("R$ 10,50") são lidos como valor. A regra vale também quando a IA repete o que anotou ("Anotei 12345, está certo?"). Antes de a IA saber o idioma de quem liga (na frase de abertura, por exemplo), vale o idioma inicial da configuração: escolha o idioma em que você escreveu a frase.
- **Confirmação:** a IA diz à pessoa o que entendeu, falando com ela ("Você foi cobrado duas vezes…"), e pergunta se está certo.
- **Confiança:** se a IA não tiver a confiança mínima da configuração sobre o que entendeu, pede para a pessoa explicar de novo.
- **Relato urgente:** se o que a pessoa conta no Entendimento bate com o que é urgente numa fila do Transferir, a IA não confirma nem passa pelos outros blocos: fala só a frase ao transferir (a frase depois de entender não é dita) e a ligação vai direto para essa fila, como urgente. Sem a confiança mínima, a IA pede para explicar de novo, como sempre. As respostas das Frases que vêm antes do Entendimento vão para a nota; as que viriam depois ficam para o atendente perguntar.
- **Tentativas:** cada "não" na Confirmação e cada pedido para explicar de novo gastam uma tentativa. Passou das tentativas de esclarecimento da configuração, a IA fala a frase de quando a IA não entende e a ligação vai para a fila de fallback.
- **Limites:** passou do tempo máximo de conversa ou do máximo de turnos (cada fala ou silêncio de 12 segundos da pessoa conta um; as falas da IA não contam), a IA fala a frase de quando a IA não entende e a ligação vai para o fallback. Se a conexão com a IA cair no meio da conversa, a ligação também vai para o fallback, mas só com o som de espera.
- **Ligação recusada:** se o assistente já estiver no máximo de ligações simultâneas, ou se a IA não puder atender (a conexão com a IA não abriu ou não ficou pronta em 10 segundos, falta a conexão STTS em Integrações ou o fluxo da ligação não foi publicado), a ligação é recusada sem ser atendida: quem liga não ouve nada, e nada vai ao chat nem à fila. A recusa fica em **Administração › Auditoria**, categoria IA, com a ação `ligacao_ia.recusada.limite` ou `ligacao_ia.recusada.falha` e o nome do assistente.
- **Na transferência:** a IA fala a frase ao transferir do bloco (sem ela, não diz nada; quando não entendeu a tempo, a frase de quando a IA não entende vai no lugar dela). A ligação só entra na fila quando a frase termina de tocar, e por isso o atendente não a corta ao entrar. Se a pessoa desligar no meio da frase, a ligação entra na fila do mesmo jeito. Depois, a IA fala os textos que a fila dá na entrada (protocolo, boas-vindas, posição, palavra de saída, se a fila os tiver) e toca o som de espera. Com a frase durante a espera preenchida, a IA a fala no intervalo configurado, com o som pausado; se a conexão com a IA cair na espera, fica só o som. Se ninguém atender dentro do tempo de espera com a IA, ela fala a frase de recusa e sai da linha; a ligação continua na fila.
- **Quando o atendente entra** (botão **Entrar na chamada** no Atendimento), a IA sai da ligação. Se ele entrar antes de a IA terminar, a nota leva o que ela já tinha entendido. A IA nunca desliga; se o atendente sair sem encerrar e ninguém voltar em 30 segundos, a ligação é encerrada. Se ele transferir a conversa com a ligação em curso, quem liga volta à espera até o próximo atendente entrar ou acabar o tempo de espera do assistente, e aí a chamada é encerrada.
- **Frase durante a espera sem a IA na conversa:** na espera depois de uma transferência e na ligação de uma conversa que já estava com gente (veja Na fila), a IA entra só para falar a frase durante a espera, no intervalo configurado e com o som pausado. Ela não ouve quem liga. A frase sai no idioma da última ligação da conversa atendida pela IA; sem nenhuma, sai como foi escrita. Se a conexão com a IA não abrir, fica só o som, e a ligação segue. Essas esperas usam a conexão com a IA e contam nas ligações simultâneas.

## Na fila

A ligação entra na fila como qualquer conversa do WhatsApp:

- **Fila:** a que a IA escolheu. Se ela não aceitar a ligação (fora do horário, sem atendentes disponíveis, desativada), vai para a fila de fallback. Se o fallback também não aceitar, a IA fala a frase de recusa logo depois da frase ao transferir e sai da linha, e a conversa não entra em fila. O mesmo acontece se o assistente não tiver fluxo da ligação publicado.
- **Urgência:** o que a IA considerar urgente, pela descrição da fila no Transferir, vai para o topo da fila, também no fallback.
- **Conversa que já estava em atendimento:** a IA não atende. A ligação vai para o atendente da conversa; se ela aguardava na fila, fica na fila. Quem liga ouve o som de espera (e a frase durante a espera, se houver) até alguém entrar na chamada ou até acabar o tempo de espera do assistente, e aí a chamada é encerrada.
- **Atendente virtual:** a ligação não vai para ele, porque a pessoa está ao telefone.
- **Nota para o atendente:** no Atendimento, um cartão **Ligação por IA** traz a fila e o motivo, as recusas, a urgência, o idioma da conversa, a confiança, o entendimento (escrito no idioma da conversa), as respostas das Frases e a transcrição.
- **Transcrição da conversa com o atendente:** com a opção ligada na configuração, alguns segundos depois do fim da ligação, um cartão **Transcrição da ligação com o atendente** entra na conversa (no Atendimento e em Supervisão), com uma linha por fala: "Quem liga: …" e "Atendente (e-mail): …", cada atendente com o seu, também depois de uma transferência. Entra só o que é dito com um atendente na chamada: a conversa com a IA já está no cartão Ligação por IA, e a espera fica de fora. As falas aparecem na ordem em que cada frase foi transcrita; uma resposta muito rápida pode sair trocada de lugar com a pergunta. A transcrição sai no idioma da conexão STTS. Se ela parar no meio, a nota avisa que parte da conversa pode faltar, e a falha fica em Administração › [Erros de sistemas externos](https://docs.run2biz.com/helper/erros-de-sistemas-externos); a ligação segue normalmente. Sem uma conexão STTS que transcreva em tempo real, nada é transcrito.
- **Avisos no chat:** com eles desligados na configuração, nenhum texto automático da fila (posição, espera, captura, transferência) vai ao chat da pessoa enquanto a ligação dura, e a espera da fila não é encerrada no meio da ligação. Ligados, o chat recebe os textos como sempre.

## Quando quem liga sai da linha

Quando a ligação termina do lado de quem liga, o sistema separa duas situações:

- **Desligou:** a pessoa encerrou a ligação.
- **Caiu:** a conexão da pessoa caiu. Conta como queda quando o WhatsApp avisa a falha ou quando, com a IA na linha, o áudio de quem liga some pelo silêncio que conta como queda da configuração antes do fim. Um corte menor, em que a ligação continua, não conta.

O que acontece depois depende de onde a conversa está:

- **Na fila, sem atendente:** a conversa espera o tempo para voltar a ligar. Se a pessoa ligar de novo nesse tempo, volta para a mesma conversa e ouve o som de espera. Se não ligar, o atendimento é encerrado como no Encerrar atendimento (com a despedida ou a avaliação da fila), e a Supervisão mostra o motivo **Não voltou a ligar**. Se alguém assumir a conversa nesse meio-tempo, ela fica com quem assumiu.
- **Com um atendente:** o atendente dono da conversa recebe um aviso no sino, **Quem ligou desligou** ou **A ligação caiu (conexão perdida)**, esteja ele na chamada ou com a ligação esperando por ele. Com o atendente na chamada, o silêncio não conta: só o aviso de falha do WhatsApp faz a ligação contar como queda.
- **Com a IA, antes de ir para a fila:** nada muda, e a conversa não entra em fila.

A ligação que caiu fica registrada como falha nos Painéis.

## Nos Painéis

Cada ligação entregue fica registrada: a fila, o idioma da conversa, a confiança da IA e como ela terminou (na fila escolhida pela IA ou o motivo do fallback). Nos [Painéis](https://docs.run2biz.com/helper/paineis), o grupo **Ligação por IA** da galeria mostra as ligações por fila, o idioma, a confiança média, o fallback por motivo e o tempo com a IA até a fila. Na ficha do contato, **Ligação por IA — vezes no fallback** conta quantas ligações dessa pessoa foram para o fallback. A ligação recusada não é entregue: não entra nessas contas e fica só na Auditoria.

## Na fatura

A Ligação por IA é cobrada por minuto, numa linha própria da fatura (**Administração › Faturas**), ao preço da tabela ou do contrato. Conta a triagem, do atendimento até a entrega na fila, e cada fala da IA depois dela: os textos da fila, a frase da espera e a frase de recusa, inclusive na espera de uma ligação transferida ou de uma conversa que já estava com gente. A música de espera e a conversa com o atendente não contam, e a ligação recusada não tem tempo com a IA.
