# Ações

<div data-with-frame="true"><figure><img src="/files/ebf93fb107174ae84cb6259c94dd62a10fd3fcd2" alt="" width="563"><figcaption></figcaption></figure></div>

### Adicionar campo de ação

Este campo é uma lista suspensa de ações que podem ser configuradas dentro do bloco.

Adicionando uma ação:

Para adicionar uma ação no bloco, clique **"+ Adicionar ação."**

<div data-with-frame="true"><figure><img src="/files/3fa63e6e9b9ac59f241172c3533f7d57df68ff7e" alt="" width="563"><figcaption></figcaption></figure></div>

Você pode selecionar uma ação nas listas de ações:

<div data-with-frame="true"><figure><img src="/files/aeff7407b0fd541aeb6f1a7ae879e662170c7bdc" alt="" width="423"><figcaption></figcaption></figure></div>

Você pode adicionar várias ações:

<div data-with-frame="true"><figure><img src="/files/dfe0d2d74866ce9959426ff41398831f3d338ac6" alt=""><figcaption></figcaption></figure></div>

### **Mover pelo funil**

Você pode selecionar em qual etapa do funil de vendas no MaviBot CRM o cliente será colocado ao entrar neste bloco. Isso é útil não apenas para avançar o cliente pelas etapas do funil, mas também para uma segmentação clara dos clientes por categorias. Por exemplo, solicitações de pessoas físicas podem ir para uma coluna, enquanto as de organizações vão para outra coluna no MaviBot CRM.

<div data-with-frame="true"><figure><img src="/files/7790dfd7d6e4397fd39b40224c918c41076edd13" alt="" width="563"><figcaption></figcaption></figure></div>

### **Adicionar à lista / Remover da lista / Mover para a lista**

Os clientes podem ser adicionados [às listas.](/doc/pt/crm/tags.md)&#x20;

As listas são usadas não apenas para segmentar a base de dados, mas também para configurar análises básicas com base nas listas.

<div data-with-frame="true"><figure><img src="/files/a544e7514f3bfd69882cc44937c3b46579f403a1" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/958f727024b508c119fde79cf466ad6be66d0833" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/8d409a4d4726625be6d77ec920efd106dfa4d5b2" alt="" width="563"><figcaption></figcaption></figure></div>

A ação "Mover para a lista" significa que o usuário será removido da lista A e adicionado à lista B.

Você pode criar novas listas e gerenciá-las na **Listas** seção, localizada no menu esquerdo do construtor.

Quando um cliente entra em um bloco com ações de lista configuradas, suas listas atribuídas são atualizadas automaticamente.

Na **Clientes** seção, você pode:

* Filtrar clientes por pertencimento à lista
* Ver a quais listas um cliente pertence no menu à direita do diálogo dele
* Ver todas as listas atribuídas no cartão de perfil do cliente

<div data-with-frame="true"><figure><img src="/files/9c75e9967724ea1586a9781c7dbf1657b64d3846" alt=""><figcaption></figcaption></figure></div>

### Adicionar tag / Remover tag

As tags simplificam a segmentação de clientes e ajudam a navegar visualmente pelos diálogos na seção Clientes. Assim como as listas, elas também podem ser usadas para filtrar clientes.

<div data-with-frame="true"><figure><img src="/files/e74859d4a081e49f82cf80696927167462442efa" alt="" width="563"><figcaption></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/a5c91aa4b2e96fec41720afd9eff5224e27b11b2" alt="" width="563"><figcaption></figcaption></figure></div>

Você pode criar e gerenciar tags [no campo **Listas** seção abaixo da **Tags** .](/doc/pt/crm/tags.md)\
Após entrar em um bloco com a ação "Adicionar tag", a tag correspondente aparecerá no diálogo do cliente.

<div data-with-frame="true"><figure><img src="/files/215045f9262cbbc7d34e48d401bb464ea86f8fab" alt="" width="375"><figcaption></figcaption></figure></div>

E você também pode ver as tags em negócios no CRM:

<div data-with-frame="true"><figure><img src="/files/c75c4e52e1483a3bd0a0bf43c26c02330c07979f" alt="" width="375"><figcaption></figcaption></figure></div>

### **Executar código Python**

<div data-with-frame="true"><figure><img src="/files/6c89a08ea652259fa25f8d411a55d39728ff3b2a" alt="" width="563"><figcaption></figcaption></figure></div>

Antes de entrar em um bloco onde é usada a ação para executar código Python, você precisa atribuir as variáveis usadas no script Python.

Todas as variáveis disponíveis na Calculadora estarão acessíveis no script: elas serão passadas em um dicionário chamado `data`; não há necessidade de criá-lo previamente.

<div data-with-frame="true"><figure><img src="/files/d2ac0429cb9ec36116b17a78384e1ab6ae614ace" alt=""><figcaption></figcaption></figure></div>

**Exemplo:**\
No bloco "Iniciar", as variáveis `primeira` e `segunda` são atribuídas.

<div data-with-frame="true"><figure><img src="/files/d8b0e28b671c28472df9fc701d4725b81ac08699" alt=""><figcaption></figcaption></figure></div>

Em seguida, no segundo bloco, defina a ação **"Executar código Python":**

<div data-with-frame="true"><figure><img src="/files/ece77e140355342ec571a250e4461937758064ac" alt=""><figcaption></figcaption></figure></div>

No código Python, você acessa essas variáveis pelas suas chaves no `data` dicionário, correspondendo aos nomes das variáveis do primeiro bloco (criando a variável `a`).\
Alternativamente, você pode se referir à variável da mesma forma que na saída de texto (criando a variável `b`).

{% hint style="info" %}
Observe, em relação à criação da variável **b** — antes de executar o script, todas as variáveis no formato `#{nome_da_variável}` são substituídas pelos valores das variáveis correspondentes, assim como ao enviar uma mensagem para o cliente.
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/bb2f32e304e03bce7e9d32bf375e16e9f7b3602a" alt=""><figcaption></figcaption></figure></div>

No final do script, a variável `resultado` é retornada contendo `{'`<mark style="color:vermelho;">`a`</mark>`': a, '`<mark style="color:vermelho;">`b`</mark>`': b, '`<mark style="color:vermelho;">`sum_ab`</mark>`': sum_ab}`. Você deve retornar os dados exatamente nesse formato para que novas variáveis sejam criadas, onde os nomes das variáveis correspondem às chaves do dicionário e seus valores correspondem aos valores do dicionário.

<div data-with-frame="true"><figure><img src="/files/b2ed16452ebc5dee907e8d366d0069182f9e9394" alt="" width="563"><figcaption></figcaption></figure></div>

#### Erros

**Falha ao baixar o arquivo** — um erro que ocorre quando o arquivo de código salvo falha ao ser baixado para execução durante o envio da mensagem.

**`result não é dict`** — o valor retornado deve ser um dicionário no formato chave–valor, como mostrado no exemplo abaixo:


---

# 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://docs.mavibot.ai/doc/pt/chatbot/builder/setting/acoes.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.