# Como mudar um ticket de uma etapa para outra de forma automática?

A função de Mudança de Etapa é uma das mais usadas e poderosas do Vambe. Ela permite que seu Assistente de Inteligência Artificial mova automaticamente um cliente de uma coluna para outra no seu funil de vendas (Pipeline), com base no que acontece na conversa.

Para que serve? Para manter seu CRM organizado sem intervenção manual.

* *Exemplo:* Se o cliente fornecer todos os seus dados (Nome, RUT, E-mail) -> Mover para "Dados Completos".
* *Exemplo:* Se o cliente disser que não tem orçamento -> Mover para "Perdidos".

***

#### 1. A Lógica: Causa e Efeito

Para que esta função opere corretamente, você deve estruturar a instrução em duas partes:

1. **A Instrução no Texto (Prompt)**: Você deve dizer explicitamente à IA, no passo a passo *quando* ela deve ativar a função.
2. **A Configuração da Função**: Você deve criar a ferramenta técnica que realiza a movimentação.

***

#### ⚠️ Erro Comum: Instrução sem Função

Este é o erro mais comum ao configurar assistentes.

Muitas pessoas escrevem no texto do passo: *"Quando o cliente responder, mude de etapa"*... **mas esquecem de criar o botão da função.**

**O que acontece se eu fizer isso?** A IA vai ler sua instrução, terá a intenção de fazer isso, mas não terá a ferramenta técnica para executar. É como dizer a um carpinteiro "pregue esse prego" e não lhe dar o martelo.

{% hint style="danger" %}
**Regra de Ouro:** Você sempre deve ver o cartão da função criada logo abaixo do texto do passo. Se estiver escrito apenas no texto, NÃO vai funcionar.
{% endhint %}

***

#### 2. Configuração Passo a Passo

Para começar, é fundamental que você acesse a configuração do seu cérebro de IA.

**Passo 1: Entrar no Assistente**

1. [Entrar no assistente](/asistentes-ia/asistentes-ia-pt-br/como-montar-os-blocos/como-ingresar-al-asistente-de-inteligencia-artificial.md)
2. Selecione o assistente que deseja editar (ou crie um novo).
3. Uma vez lá dentro, localize os blocos de Passos a Seguir ou Casos Possíveis. Lembre-se de que as funções só existem dentro desses dois blocos.

**Passo 2: Escrever a Instrução**

Dentro do bloco (Passos ou Casos), redija no texto a condição disparadora.

* *Fórmula:* `Quando [acontecer X coisa], você deve executar a função [Nome da função]`.

> Exemplo Real: "Quando o cliente me responder às perguntas do RUT e Nome, você deve executar a função Mudança de Etapa para Pendente Cotação".

<figure><img src="/files/edd428f59c4b9e3de041d13a025a4fa27c81393e" alt=""><figcaption></figcaption></figure>

**Passo 3: Criar a Função (Indispensável!)**

Logo abaixo do texto onde você escreveu a instrução, clique em **Adicionar Função** e **selecione Mudança de Etapa**.

<figure><img src="/files/2eb954089370b91a2d6ac0dbd51e3d4ee959d481" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/42a12fa2ddb6f75b8e9685881cecec1bd02fe469" alt=""><figcaption></figcaption></figure>

Será aberto um painel de configuração onde você deve preencher dois campos vitais:

1. **Etapa de Destino**: Selecione para qual coluna do funil você quer mover o cliente (Ex: "Pendente Enviar Cotação").
2. **Descrição (CRUCIAL!)**: Aqui você deve explicar à IA quando é o momento certo de usar esta ferramenta.
   * *Dica:* Copie e cole a mesma "Causa" que você escreveu no texto do Passo 2.
   * *Exemplo de Descrição:* "Quando o cliente me responder às perguntas".

<figure><img src="/files/26860069bb1bde9ba524b0e5a77fe4f50bbf746b" alt=""><figcaption></figcaption></figure>

**Passo 4: Verificação Visual (Como deve ficar?)**

Depois que você clicar em "Criar", é fundamental confirmar que a função foi anexada corretamente.

Assim fica uma configuração correta: você deve ver o texto da sua instrução acima e, logo abaixo, um cartão branco com o ícone da função e o nome que você atribuiu a ela. Se não vir o cartão, a função não existe.

<figure><img src="/files/fc2ec29ed4910078fec7c555fe0fec4d931149f5" alt=""><figcaption></figcaption></figure>

***

#### 3. Manejo de Múltiplos Caminhos

Uma das grandes vantagens desta função é que a IA pode decidir entre **vários caminhos** em um mesmo passo, com base na **Descrição** que você deu a cada função.

**Caso de Exemplo**: Imagine que você está solicitando o RUT.

* **Caminho A:** O cliente fornece o RUT correto -> Mover para a etapa "Dados Ok".
* **Caminho B:** O cliente diz que é estrangeiro e não tem RUT -> Mover para a etapa "Sem RUT".

**Configuração**: No mesmo passo, você adicionaria duas funções de Mudança de Etapa diferentes:

1. **Função A:**
   * *Destino:* Dados Ok.
   * *Descrição:* "Quando o cliente me fornece seu RUT corretamente".
2. **Função B:**
   * *Destino:* Sem RUT.
   * *Descrição:* "Quando o cliente informa que não tem RUT por ser estrangeiro".

<figure><img src="/files/d14da780020502afb1309358f26b2ce684a0793f" alt=""><figcaption></figcaption></figure>

Graças à descrição, a IA saberá qual das duas ferramentas "tirar da caixa" de acordo com a resposta do usuário.


---

# 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/funcoes/como-cambiar-un-ticket-de-una-etapa-a-otra-de-forma-automatica.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.
