> ## Documentation Index
> Fetch the complete documentation index at: https://help.vistum.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Blocos de IA

> Extrair nome e e-mail, classificar interesse e transcrever áudio dentro da automação — cada execução consome 1 crédito de IA.

## O que a IA faz aqui

A IA lê alguma coisa da conversa e **guarda a resposta numa variável**. Ela não envia nada para o cliente — quem envia é o bloco de **Mensagem** que você coloca depois.

É sempre a mesma receita, com três blocos prontos:

<Steps>
  <Step title="A IA lê e guarda">
    Você adiciona o bloco. Ele já vem com a instrução escrita.
  </Step>

  <Step title="Você usa o que ela guardou">
    Numa **Mensagem**, numa **Condição** ou numa **Ação** logo abaixo.
  </Step>
</Steps>

## Os três blocos

Na paleta, grupo **IA**:

| Bloco                     | O que faz                                   | Guarda em        |
| ------------------------- | ------------------------------------------- | ---------------- |
| **Extrair nome e e-mail** | Puxa nome e e-mail do que a pessoa escreveu | `{{aiContact}}`  |
| **Classificar interesse** | Diz se o lead está frio, morno ou quente    | `{{aiInterest}}` |
| **Transcrever áudio**     | Vira texto o áudio que o cliente mandou     | `{{aiAudio}}`    |

Cada bloco já nasce com a instrução pronta. Você pode ajustar o texto do seu jeito, mas não precisa começar do zero.

## Como usar o resultado

Esta é a parte que costuma travar. A IA guardou a resposta — **e agora?**

O próprio bloco te diz, no painel, em **"E agora?"**. Mas a receita é sempre uma destas três:

### Escrever a resposta numa mensagem

Coloque um bloco **Mensagem** depois e escreva a variável no texto:

```
Oi! Entendi que você falou: {{aiAudio}}
```

### Mudar o caminho do fluxo

Coloque um bloco **Condição** depois e escolha **"Variável IA igual a"**:

<Steps>
  <Step title="Campo">
    Escolha **Variável IA igual a**
  </Step>

  <Step title="Variável">
    Digite `aiInterest` (sem as chaves)
  </Step>

  <Step title="Valor">
    Digite `quente`
  </Step>
</Steps>

O fluxo passa a ter dois caminhos: **Sim** (lead quente) e **Não**. Se você precisa de mais de dois caminhos — frio, morno **e** quente — use o bloco **Dividir / Switch** com assunto **Variável**.

### Salvar no cadastro

Use uma **Ação** do tipo **Atualizar contato** para gravar o que a IA extraiu.

## Transcrever áudio

<Note>
  O bloco só transcreve quando **a mensagem que disparou a automação for um áudio**. Se o contato mandar um texto, o bloco não faz nada, não gasta crédito, e a variável fica com `[sem áudio]`. O fluxo continua normalmente.
</Note>

Um fluxo típico:

<Steps>
  <Step title="Gatilho">
    **Mensagem recebida**
  </Step>

  <Step title="Transcrever áudio">
    O que a pessoa falou vira texto em `{{aiAudio}}`
  </Step>

  <Step title="Responder">
    Um bloco **Mensagem** usando `{{aiAudio}}`, ou uma **Condição** do tipo **Variável IA contém** para reagir ao que foi dito
  </Step>
</Steps>

**Limites:**

* Áudios com mais de **3 minutos** são ignorados — a variável vira `[áudio ignorado]` e o fluxo segue.
* Se não houver áudio, a variável vira `[sem áudio]` e o fluxo segue. **O bloco nunca trava a automação.**
* O mesmo áudio **nunca é cobrado duas vezes**: a transcrição fica guardada.

## Créditos

<Warning>
  **Cada execução de um bloco de IA consome 1 crédito** do seu plano. O bloco **Transcrever áudio** consome **1 crédito a mais** pela transcrição em si — ou seja, 2 no total.
</Warning>

Para não gastar à toa, use a IA **depois de filtrar** — por exemplo, só para quem chegou numa certa etapa, em vez de para todo mundo que entra no fluxo.

## Qual modelo é usado

<Note>
  Todas as automações usam o **mesmo modelo**, escolhido pela Vistum. Não existe seletor: você não precisa entender de modelo de IA para usar o bloco. O que muda para você é só o **consumo de crédito**, que é igual em qualquer bloco.
</Note>

## Disponibilidade

<Note>
  Os blocos de IA estão disponíveis a partir do plano **Crescimento**. Em planos sem IA, os blocos aparecem marcados como **pro** e não podem ser usados.
</Note>

## Boas práticas

<Tip>
  **Teste antes de publicar.** Use o botão **Testar** para ver o fluxo rodar sem enviar nada ao cliente.
</Tip>

<Tip>
  Se a resposta da IA vier diferente do esperado, **seja mais específico na instrução**. Ex.: em vez de "classifique o lead", escreva "responda exatamente uma palavra: frio, morno ou quente".
</Tip>

<Note>
  Para perguntas com poucas respostas possíveis (Sim / Não / qual produto), um bloco [Perguntar com botões](/automacoes/botoes-listas-menu) resolve melhor e **sem gastar crédito**. Reserve a IA para o que é aberto — texto livre e áudio.
</Note>

## Próximos passos

* [Bloco Condição: bifurcar o fluxo](/automacoes/bloco-condicao)
* [Bloco Perguntar e Aguardar Resposta](/automacoes/perguntar-aguardar)
* [Exemplos prontos de automações](/automacoes/exemplos-prontos)