Tutorial 5 de 5 · Automações

Bloco de Inteligência Artificial

É o bloco mais poderoso. Com ele, a automação “lê” a conversa do cliente e entende o que está acontecendo: qual a intenção, o sentimento, quais dados foram ditos — e pode até escrever respostas. Você usa a sua própria chave de IA (OpenAI, Anthropic ou Google).

1. O que é o bloco de IA

Os blocos comuns reagem a regras fixas. O bloco de IA vai além: ele interpreta texto em linguagem natural. Na prática, ele consegue:

  • Entender a intenção do cliente (quer comprar? tirar dúvida? reclamar?);
  • Medir o sentimento (positivo, neutro, negativo);
  • Extrair dados da conversa (nome, e-mail, produto de interesse);
  • Transcrever áudios do WhatsApp em texto;
  • Gerar respostas escritas com base na conversa.

2. Passo zero: cadastrar sua chave (BYOK)

O bloco usa o modelo BYOK“traga sua própria chave” (Bring Your Own Key). Você conecta sua conta de IA, e o consumo é cobrado diretamente pelo provedor (OpenAI, Anthropic ou Google). Assim você tem controle total do custo.

  1. Crie uma chave no provedor

    Na sua conta da OpenAI, Anthropic ou Google, gere uma API Key e garanta que há crédito disponível.

  2. Abra Configurações → Chaves de API

    No app, vá em ConfiguraçõesChaves de API.

  3. Cole a chave e salve

    Escolha o provedor, cole a chave e ative. Cada empresa pode ter uma chave por provedor.

Sem chave, o bloco não roda Se nenhuma chave ativa estiver cadastrada para o provedor escolhido, o bloco de IA falha na execução. É o primeiro item a conferir se algo não funcionar.

3. Adicionando o bloco no fluxo

  1. Adicione o bloco “IA”

    No +, escolha IA.

  2. Escolha o provedor e o modelo

    Selecione, por exemplo, OpenAI → GPT-4o mini (rápido e econômico). Cada provedor oferece modelos mais rápidos/baratos ou mais capazes.

  3. Adicione uma ou mais ações de IA

    Dentro do bloco, clique em + Adicionar ação de IA e escolha o que a IA deve fazer (ver próxima seção). Cada ação tem seu botão de lixeira para remover.

  4. Dê instruções

    Em vários casos você pode escrever instruções extras para guiar a IA (tom de voz, regras). Esses campos também aceitam variáveis { }.

IA · OpenAI
GPT-4o mini
🗣️ Intenção de conversa
😊 Sentimento
Intenção: Comprar
Intenção: Dúvida
Nenhuma intenção
Média Tokens: 312
Bloco de IA com duas ações. A ação de Intenção cria portas de saída — uma por intenção configurada — além de Nenhuma intenção.

4. As ações de IA, uma a uma

🗣️ Intenção de conversa

Você cadastra uma lista de intenções possíveis (ex.: Comprar, Dúvida, Reclamação). A IA lê a conversa e decide qual encaixa melhor. Cada intenção vira uma porta de saída no bloco, mais uma porta “Nenhuma intenção” — então o fluxo segue por caminhos diferentes para cada caso.

😊 Sentimento da conversa

A IA classifica o humor do cliente (ex.: positivo, neutro, negativo). Assim como a intenção, gera portas de saída para você tratar cada sentimento de um jeito — por exemplo, escalar para um humano quando for negativo.

🧾 Extrator de parâmetros

Você define os campos que quer capturar (ex.: nome, email, produto). A IA lê a conversa e preenche cada um. Ótimo para qualificar o lead sem formulário.

🎙️ Transcrição de áudio

Converte os áudios enviados pelo cliente em texto. Útil para registrar o que foi dito e alimentar outras ações de IA.

✍️ Gerar texto / 💬 Assistente de chat

Geram uma resposta escrita com base na conversa atual. Use o resultado para sugerir uma resposta ao atendente ou compor uma mensagem.

Invocar Agente aparece no construtor marcado como “Em breve” — será habilitado em uma próxima atualização.

5. Usando o resultado da IA (variáveis)

Cada bloco de IA tem um nome de saída (por padrão algo como AI-1). O que a IA produzir fica guardado nesse nome e pode ser reaproveitado nos blocos seguintes como variável {{ }}:

VariávelContém
{{AI-1.resposta}}o texto gerado (assistente / gerar texto)
{{AI-1.intencao}}a intenção identificada
{{AI-1.sentimento}}o sentimento identificado
{{AI-1.texto}}a transcrição do áudio
{{AI-1.nome}}, {{AI-1.email}}cada parâmetro extraído (pelo nome que você deu)

Esses valores aparecem automaticamente no seletor de variáveis { } dos blocos seguintes — por exemplo, dentro de uma Ação de comentário ou de uma Mensagem.

Exemplo Coloque um bloco de IA com Gerar texto e, logo depois, uma Ação Adicionar comentário no lead com o conteúdo {{AI-1.resposta}}. A IA escreve, e a anotação aparece sozinha na aba Anotações do lead.

6. Intenção e Sentimento: caminhos diferentes

As ações de Intenção e Sentimento são especiais porque ramificam o fluxo. Em vez de uma saída única, o bloco mostra uma porta para cada opção que você cadastrou:

  1. Cadastre as intenções (ex.: Comprar, Dúvida, Reclamação).
  2. O bloco passa a exibir uma porta por intenção + a porta “Nenhuma intenção”.
  3. Ligue cada porta ao caminho certo: Comprar → criar negócio; Reclamação → notificar gestor; Nenhuma → enviar mensagem padrão.

É a forma mais natural de montar um atendimento que “entende” o cliente e reage de acordo.

7. Custo e tokens

Toda chamada de IA consome tokens (a “unidade de medida” do texto processado), e isso é cobrado pelo seu provedor. Para você acompanhar, o rodapé do bloco mostra a Média Tokens — a média de tokens gastos por execução, calculada a partir do consumo real registrado.

Economize: prefira modelos “mini/flash” para tarefas simples (classificar intenção, extrair dados) e reserve os modelos mais caros para quando precisar de respostas elaboradas. Instruções curtas e objetivas também reduzem o consumo.

Pronto — você já conhece todas as peças das automações. Para começar rápido, explore os modelos prontos ou volte ao hub de Automações.

Conecte sua chave de IA

Vá em Configurações → Chaves de API e ative seu provedor para testar o bloco.

Ir para o app