# Funções em Assistentes com Cenários (V3)

As Funções são as ações que seu assistente pode executar: mudar de etapa, enviar um template, criar uma nota, executar um Flow ou até interagir com ferramentas externas. Nos assistentes V3, as funções são gerenciadas de forma centralizada no nível do assistente e referenciadas a partir das rotas.

***

### Como funcionam as funções no V3?

Nos assistentes V2 (com blocos), as funções eram configuradas dentro de cada bloco de Passos a seguir ou Casos possíveis. No V3 o modelo muda:

1. **Primeiro você associa a função ao assistente** — você a registra uma vez em nível global.
2. **Depois você a referencia nas rotas** — você diz em que momento ela deve ser executada.

Isso significa que uma mesma função pode ser usada em várias rotas e cenários sem precisar configurá-la toda vez.

***

### Como adicionar uma função ao assistente

1. Dentro do seu assistente, clique na aba **Funções**.
2. Clique em **+ Adicionar função** (ou o botão de busca para encontrar uma existente).
3. Selecione o **tipo de função** que você precisa:

| Tipo de função                 | O que faz                                                                         |
| ------------------------------ | --------------------------------------------------------------------------------- |
| **Mudança de Etapa**           | Move o ticket para outra etapa do funil quando a condição for atendida            |
| **Remover contato do funil**   | Remove o contato do funil se a condição for atendida                              |
| **Enviar Template**            | Envia um template pré-criado da seção "Templates"                                 |
| **Enviar Áudio**               | Envia um áudio com a voz selecionada                                              |
| **Chamada de Webhook**         | Executa um webhook quando a condição for atendida                                 |
| **Criar Nota**                 | Gera uma nota automaticamente (as notas não são enviadas ao cliente)              |
| **Enviar Documento ou Imagem** | Envia um arquivo quando a condição for atendida                                   |
| **Executar Flow**              | Aciona um Flow com parâmetros personalizados                                      |
| **Disparar Evento**            | Dispara um evento quando a condição for atendida                                  |
| **Buscar na Internet**         | Realiza uma busca na internet de acordo com a condição definida                   |
| **Obter Status do Pedido**     | Obtém o status de um pedido de um fornecedor específico                           |
| **Integração com Slack**       | Permite que a IA envie mensagens ou notificações para canais do Slack.            |
| **Integração com Notion**      | Permite que a IA crie novas páginas ou itens em bancos de dados do Notion.        |
| **Integração com Linear**      | Permite que a IA crie tickets ou issues no Linear para acompanhamento de tarefas. |

4. Preencha os dados da função (nome, descrição e configuração conforme o tipo).
5. Salve. A função ficará associada ao assistente e disponível para ser usada em qualquer rota.

> 💡 Se você precisar integrar o Vambe com outra ferramenta externa não listada, pode clicar no botão **'Solicitar integração'** para explorar nosso catálogo com centenas de apps. Adicionar uma nova integração é um processo ágil.

***

### A descrição da função: o mais importante

> ⚠️ **A descrição da função é crítica.** A IA a usa para saber quando executá-la. Se a descrição for vaga, a função será executada em momentos incorretos ou não será executada quando deveria.

**Exemplo de descrição ruim:** *"Mudar etapa"*

**Exemplo de descrição boa:** *"Executar quando o cliente tiver confirmado que quer agendar uma consulta e tiver informado seu nome, RUT e data desejada."*

Quanto mais específica e descritiva ela for, mais precisa a IA será ao usá-la.

***

### Como referenciar uma função em uma Rota

Uma vez que a função esteja associada ao assistente, você pode referenciá-la em qualquer rota de duas formas:

**Forma 1 — Nomeá-la nas instruções:** Basta mencionar o nome da função dentro do texto da rota. A IA reconhecerá que deve executá-la quando apropriado.

Exemplo: *"Assim que o cliente confirmar que quer comprar, execute a função 'Mudar etapa para Venda'. Se o cliente pedir um ticket de suporte, use a função 'Integração com Linear' para criar um."*

**Forma 2 — Adicioná-la explicitamente como ação da rota:** No editor da rota, você pode adicionar a função como uma ação direta, assim como nos casos possíveis do V2.

> 💡 Não é obrigatório mencionar a função em cada rota. Se ela estiver associada ao assistente e sua descrição for clara, a IA pode ativá-la por contexto sem que você a indique explicitamente na rota. No entanto, para funções críticas (como mudanças de etapa ou a criação de um ticket externo), sempre é melhor ser explícito.

***

### Exemplo prático

**Contexto:** Loja de roupas que quer mudar de etapa quando o cliente confirma uma compra e criar um ticket se houver um problema.

**Funções associadas ao assistente:**

* Nome: *"Mudar etapa para Compra confirmada"*
* Descrição: *"Executar quando o cliente tiver escolhido um produto, confirmado o tamanho e dito que quer comprá-lo."*
* Nome: *"Criar ticket no Linear para suporte"*
* Descrição: *"Ativar quando o cliente relatar um problema ou erro com o pedido que exija acompanhamento por parte da equipe de suporte no Linear. Deve incluir os detalhes do problema fornecidos pelo cliente."*

**Rota em que é referenciada:**

* Cenário: *"Processo de compra"*
* Rota: *"Confirmação de compra"*
* Instruções: *"Quando o cliente confirmar que quer o produto, agradeça a escolha, indique os passos para pagar e execute a função 'Mudar etapa para Compra confirmada'."*
* Cenário: *"Gestão de ocorrências"*
* Rota: *"Relato de problema com pedido"*
* Instruções: *"Quando o cliente informar um problema com o pedido, colete os detalhes (número do pedido, tipo de problema, urgência) e depois use a função 'Criar ticket no Linear para suporte' para registrar a ocorrência. Informe ao cliente que o caso foi escalado e que ele receberá uma resposta em breve."*

***

### Pontos-chave para lembrar

* As funções são configuradas **uma vez em nível de assistente** e são reutilizadas em todas as rotas que precisarem delas.
* A **descrição da função** é o que a IA usa para saber quando executá-la — escreva com detalhes.
* Você pode referenciar uma função nomeando-a no texto da rota ou adicionando-a como ação explícita.
* Uma função bem descrita pode ser ativada por contexto sem necessidade de mencioná-la em cada rota.
* As novas integrações com Slack, Notion e Linear ampliam significativamente as ações que seu assistente V3 pode realizar em ferramentas externas.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.vambe.ai/asistentes-ia/asistentes-ia-pt-br/assistentes-com-cenarios-v3/funciones-en-asistentes-con-escenarios-v3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.