Skip to content
Para o administrador da conta › Automação e IA
Automação e IA

O nó de IA: criar e configurar do zero

O bloco Transferir p/ IA campo por campo: provedor e créditos, prompt, fuso e horário de atendimento, temperatura, tokens, extrair variáveis, AI Tasks e ações prontas, catálogo com cobrança PIX e resposta em áudio/voz.

20 min de vídeo 14 imagens Painel do administrador
Aula gravada na plataforma real. O cursor, as legendas e o destaque existem só no vídeo.

O nó Transferir p/ IA é a fronteira do fluxo. Antes dele, quem responde é o que você montou: mensagens fixas, perguntas, condições. Depois dele, quem responde é a IA, lendo o que a pessoa escreveu.

Construtor de fluxos com o nó de IA recém-criado e o painel aberto
Um clique na paleta cria o bloco e abre o painel de propriedades à direita.

Onde ele fica

Na paleta da esquerda, família Lógica, com o nome Transferir p/ IA. Um clique já coloca o bloco no quadro — não é preciso arrastar.

Provedor: nativo ou chave própria

O provedor é quem pensa pela IA, e há dois caminhos:

  • Nativos do Heyoo (no topo da lista) — consomem os créditos da sua conta. Escolhendo um deles, os campos Modelo e API Key desaparecem: o Heyoo resolve os dois. O painel passa a mostrar o seu saldo de créditos.
  • Chave própria — OpenAI, Google Gemini, DeepSeek e Anthropic (Claude). Você escolhe o modelo, cola a sua chave, e a cobrança é direto com o provedor.
Campo Provedor de IA com o provedor nativo Heyoo e o aviso de saldo de créditos
Com um provedor nativo selecionado, o painel mostra o saldo de créditos e esconde modelo e chave.
Campo Provedor de IA com OpenAI selecionado, mostrando modelo e chave
Trocando para um provedor de chave própria, aparecem os campos Modelo e API Key que o nativo escondia.
O teste rápido só existe na chave própriaO painel que testa a IA com uma mensagem de exemplo não aparece quando o provedor é nativo do Heyoo — ele exige a API Key. Com o provedor nativo, o teste é rodar o fluxo de verdade.

A instrução — o prompt

É o campo mais importante do nó: define quem a IA é, o que ela pode dizer e — o que mais importa — o que ela não deve prometer. Frases como nunca invente preço ou horário valem mais do que qualquer ajuste técnico.

Campo de texto com a instrução da IA
O campo Instrução para a IA, logo abaixo do provedor.

Estúdio de prompt

Duas ajudas para não começar do zero:

  • Modelos — três pontos de partida prontos: Secretária / Agendamento, Vendas / SDR e Suporte / Atendimento. Vêm com colchetes para trocar pelo nome do seu negócio.
  • Gerar com IA — você descreve o negócio e ela escreve o prompt. Antes de trocar, o painel mostra o texto novo e pede confirmação: o seu prompt não some sozinho.
Lista de modelos de prompt: Secretária, Vendas e Suporte
Os três modelos prontos do Estúdio de prompt.

Fuso e horário de atendimento

O fuso decide que horas a IA acha que são (padrão Brasília; há também Manaus, Acre, Fernando de Noronha, UTC, Lisboa e Nova York).

Bloco de horário de atendimento do nó de IA
Horário de atendimento e, dentro dele, a chave Responder por período.
Campo Responder por período com horários e palavras-gatilho
Responder por período aberto: janela própria de início e fim, com as palavras-gatilho que furam o silêncio.
Dois campos parecidos que fazem coisas diferentesHorário de atendimento informa à IA se o negócio está aberto ou fechado agora e quando reabre — assim ela não erra ao falar de horário. Responder por período é outra coisa: uma janela em que a IA tem permissão de falar. Fora dela ela fica em silêncio, e responde quando a janela abrir — com palavras-gatilho (urgente, emergência) que furam o silêncio.

Como ela responde

  • Temperatura — de Preciso a Criativo. Para atendimento, quanto mais preciso melhor: criatividade demais vira informação inventada.
  • Mensagens de referência — quanta conversa anterior entra no contexto (padrão 10). Poucas demais e a IA repete a saudação e o nome a cada resposta.
  • Penalidade de repetição — só aparece em OpenAI e DeepSeek; Gemini e Anthropic ignoram esse ajuste.
Campos dividir resposta, mostrar digitando e aguardar rajada
Os três campos que dão ritmo humano à resposta.

Dividir resposta manda o texto em balões curtos. Mostrar “digitando…” exibe o indicador onde o canal aceita. Aguardar mensagens em rajada é o mais útil: se a pessoa manda quatro mensagens seguidas, a IA espera e responde tudo de uma vez — com 0 segundos ela responde na hora e a conversa vira uma resposta picotada para cada linha.

Quando a IA volta a atender

Quando um humano assume a conversa, a IA pausa sozinha. Reativar após inatividade decide se ela volta — nunca, ou depois de 30 min, 1 h, 2 h, 4 h, 8 h ou 24 h sem nenhuma mensagem nova. Em Nunca, só o botão no topo da conversa a traz de volta.

Fallback vazio = cliente sem respostaA mensagem de fallback é enviada quando o provedor de IA falha mesmo após novas tentativas. Deixando o campo vazio, nada é enviado — e a pessoa fica sem resposta em vez de receber um aviso.

Extrair informações (slot-filling)

Faz a IA ler a conversa e guardar dados em variáveis para os próximos nós. Cada linha tem o nome da variável e, em português, o que procurar.

Editor de extração de informações do nó de IA
O mapeamento de extração: nome da variável à esquerda, o que extrair à direita.
Use nomes novosVariáveis do sistema — nome, mensagem e telefone do contato, e as de data e hora — são ignoradas de propósito aqui, para que a IA não sobrescreva o que a plataforma já preenche.

Ferramentas (AI Tasks)

Ligando AI Tasks, a IA deixa de só conversar. Cada task que você cria vira uma saída do bloco no quadro: a IA decide qual chamar e o fluxo ramifica por ali — é assim que ela consulta uma agenda ou registra um pedido.

Editor de AI Tasks com as ações prontas
As tasks criadas viram saídas; as três ações prontas, abaixo, não.
As três ações prontas não viram saídaQuem executa Chamar o dono da conta, Assunto fora do atendimento e Atualizar o CRM é o próprio Heyoo — por isso elas não precisam de nó ligado. A primeira aciona você por sino e push e pausa o atendimento; a segunda faz a IA não responder nada e sair de cena (útil quando o número também recebe mensagem pessoal); a terceira cria e move o card no funil de Vendas, sem dizer nada ao cliente.

Catálogo, mídia e comentários

  • Vender do catálogo — entrega à IA os produtos ativos, com preço e link. Catálogo grande consome mais tokens a cada resposta.
  • Catálogos que esta IA pode vender — aparece com a venda ligada. Marcando alguns, a IA vende só aqueles; sem marcar nenhum, ela usa todos os produtos ativos.
  • Cobrar pela Carteira (PIX) — quando o cliente confirma a compra, a IA gera uma cobrança PIX real na sua Carteira Digital e envia o link e o copia-e-cola.
  • Entender imagem/áudio/documento — a IA passa a ler o que o cliente manda além de texto.
  • Comentários: onde responder — vale para os fluxos de comentário do Instagram e do Facebook: público responde sob o post, privado abre a DM, híbrido faz as duas.
Seletor de catálogos e interruptor de cobrança pela Carteira
Com a venda ligada: a lista de catálogos e, abaixo, a cobrança PIX pela Carteira Digital.
A cobrança PIX exige a Carteira ativaCobrar pela Carteira só funciona com a Carteira Digital ativa (Marketplace › Carteira Digital). Sem ela, o interruptor fica ligado e não tem efeito — a IA fecha a venda e a cobrança não sai.
Uma única mensagem por comentárioNo privado, a Meta permite uma só mensagem por comentário, em até 7 dias. Não dá para puxar conversa no direct a partir de um comentário antigo.

Responder em áudio

Três modos: sempre texto, acompanhar o cliente (responde em áudio se receber áudio, em texto se receber texto — mudando no meio da conversa) ou sempre em áudio. Para acompanhar funcionar, ligue também Entender imagem/áudio/documento.

Campos de resposta em áudio do nó de IA
Modo de voz, provedor, voz e qualidade do áudio.
Campos provedor de voz, voz do áudio e qualidade
Os campos que só existem com a voz ligada: provedor, voz e qualidade do áudio.

O provedor de voz repete as duas naturezas: o nativo do Heyoo consome créditos e não pede chave; a OpenAI exige a sua. A qualidade HD gera um áudio mais nítido e consome cerca do dobro de créditos. Se o áudio falhar, a IA responde em texto.

Variáveis disponíveis

No fim do painel ficam as variáveis que você pode usar na instrução e nas mensagens: nome, mensagem e telefone do contato, mais data e hora atuais em quatro formatos.

Lista de variáveis disponíveis no nó de IA
As variáveis que a IA e as mensagens do fluxo podem usar.