Ligação por IA
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 (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; 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, 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.