IA no funil

Os blocos do grupo Inteligência Artificial colocam a IA em pontos específicos do funil: escrever uma resposta, decidir por qual caminho o contato segue, entender um áudio ou tirar dados de uma conversa. A IA usa a sua própria chave de um provedor (o token), cadastrada na tela Agentes IA.

#Antes de começar

• Cadastre pelo menos um token de IA em Automação › Agentes IA, aba Tokens de IA. Sem token, os blocos mostram o aviso «Configure os tokens em Agentes IA → Configurações de tokens antes de usar IA nos fluxos.»
• Para os blocos Resposta com IA e Chamar Agente IA, tenha um agente criado. Dá para criar pelo próprio bloco, em + Criar novo agente.

#Qual bloco usar

#Resposta com IA

Gera um texto com um agente e, se você quiser, já envia.

#Destinos

O texto fica também na variável do campo Guardar o texto também em (opcional). O padrão é {{vars.ai_response}}.

#Conversa com IA ativa

Só para o destino Contato do funil.

• Com Manter IA ativa aguardando respostas marcado, a IA envia, espera o contato e responde de novo a cada mensagem, até encerrar ou o tempo acabar. Defina o Tempo máximo sem resposta (minutos). O bloco ganha duas saídas: IA encerrou e Tempo esgotado.
• Desmarcado, a IA envia uma vez e o funil segue para o próximo bloco.

#Chamar Agente IA

Entrega a conversa a um agente até ele concluir a tarefa. Use quando a etapa é um atendimento inteiro: tirar dúvidas, qualificar, agendar.

• Escolha o Agente IA e escreva as instruções da etapa.
• Timeout sem resposta do lead (minutos): quanto tempo esperar o contato.
• O tempo de resposta da IA é o configurado no próprio agente.

O bloco tem duas saídas:

• Concluído: a tarefa foi cumprida.
• Precisa de humano: o contato pediu atendente ou parou de responder.

#Roteador IA

A IA lê a conversa e segue por uma das saídas que você nomear. Cada saída tem um nome (ex.: «Quer comprar») e, se quiser, uma descrição de quando usar. O bloco aceita até 8 saídas e precisa de pelo menos duas.

O que a IA não conseguir encaixar sai por Não classificado, que existe sempre. Ligue essa saída a algum bloco, para não perder ninguém. Se a IA falhar, o contato também sai por ela.

Em Prompt base (critério de classificação), explique como você explicaria a um atendente novo qual saída usar em cada caso. Em Salvar a saída escolhida em (opcional), dê um nome de variável para usar a escolha nos blocos seguintes.

#Entender áudio ou imagem

Transcreve o áudio ou descreve a imagem que o contato enviou. O bloco escolhe sozinho pelo tipo do anexo. O texto fica na variável de Salvar o texto em.

Se não houver mídia, ou se a leitura falhar, o funil continua pela mesma saída e o motivo fica na variável.

#Resumir conversa

Resume a conversa para quem for assumir o atendimento. Defina Salvar o resumo em e o Máximo de linhas. Marque a opção de registrar também como nota da conversa para o resumo ficar no histórico do Chat de conversas.

#Extrair dados

A IA lê a conversa e devolve cada campo separado, já conferido pelo tipo. O que ela não encontra fica vazio, nunca inventado.

• Em Campos a extrair, adicione até 10 campos. Cada um tem um nome de variável, uma descrição do que extrair e um tipo: Texto, Número, Valor (R$), Data, Telefone, E-mail ou Uma das opções.
• Para cada campo, escolha onde guardar: Só variável do funil, Também no cadastro do contato ou Também num campo personalizado.
• Sobrescrever o que já está no cadastro: desligado, o bloco só preenche campo vazio. Assim um contato que já tem nome não o perde porque a IA leu outro nome numa mensagem.

Cada campo vira {{vars.nome_da_variavel}} nos blocos seguintes.

#Pontuar lead

A IA dá uma nota de 0 a 100 pelo critério que você escrever (ex.: «100 = pediu link de pagamento; 0 = só perguntou preço e sumiu»). A nota fica na variável de Salvar a nota em. Combine com uma Condição de Variável do fluxo usando Maior que.

#Agente com ferramentas

A IA pode consultar antes de responder. Não está disponível em funis do canal Chatbot.

O bloco aceita até 6 ferramentas e faz no máximo 4 consultas por execução. Atingido o limite, a IA responde com o que tiver. Cada consulta fica registrada no histórico da execução.

#Token e modelo

Nos blocos Roteador IA, Entender áudio ou imagem, Resumir conversa, Extrair dados, Pontuar lead e na condição com IA, você escolhe:

Nos blocos Resposta com IA e Chamar Agente IA, o token e o modelo vêm do agente escolhido.

#Se a IA falhar

• No Roteador IA, o contato sai por Não classificado.
• Na Resposta com IA, quando a IA não responde (sem token, provedor fora do ar), nada é enviado e o funil segue para o próximo bloco. A variável do texto recebe o motivo.
• Na Resposta com IA com envio ao contato, se o envio em si não sai, a execução para nesse bloco. Os motivos mais comuns: contato sem conversa no Chat de conversas, fora da janela de 24 horas, grupo não escolhido ou número pausado.

#Problemas comuns

«Configure os tokens em Agentes IA → Configurações de tokens antes de usar IA nos fluxos.»

Não há token de IA pronto para uso. Cadastre um em Automação › Agentes IA, aba Tokens de IA.

«Selecione o Agente IA do bloco «Chamar Agente IA» antes de ativar.»

O bloco está sem agente. Escolha um agente no painel do bloco e publique de novo.

«Ligue a saída «Não classificado» do Roteador IA…»

A saída Não classificado está solta. Ligue a um bloco, mesmo que seja a uma mensagem genérica ou a uma transferência para a equipe.

«Adicione pelo menos 2 saídas nomeadas no Roteador IA.»

O roteador precisa de pelo menos duas saídas com nome para ter o que escolher.

O contato recebeu a mesma resposta duas vezes

O bloco Resposta com IA está enviando ao contato e há um bloco de Mensagem logo depois com {{vars.ai_response}}. Apague um dos dois envios.

«Escolha pelo menos um grupo — sem grupo o funil para neste bloco com erro.»

O destino é Grupo do WhatsApp e nenhum grupo foi marcado. Selecione o grupo da equipe.

#Veja também

• Blocos de lógica
• HTTP Request
• Criar um agente
• Provedores e modelos