# Blocos e tipos

## Como trabalhar com blocos

{% hint style="info" %}
O MaviBot permite que você crie um chatbot projetando sua estrutura como um fluxograma composto por blocos e setas.
{% endhint %}

Um **bloco** representa uma ação ou evento que o bot precisa processar ou executar.

{% hint style="danger" %}
**Por favor, observe!**

**Limites de blocos:**\
O limite total por fluxograma não é maior que **500 blocos** dos seguintes tipos:

* **Bloco Start**
* **Bloco de gatilho**
  {% endhint %}

Há Conexões entre os blocos, nas quais você pode definir uma condição e/ou o horário exato para a transição para o próximo bloco.

{% hint style="info" %}
**Blocos condicionais** servem para acionar o bot sob condições específicas.\
**Blocos incondicionais** operam apenas quando alcançados por meio de setas ou callbacks (que abordaremos mais tarde).
{% endhint %}

{% hint style="warning" %}
**Por favor, observe!**

**Blocos e conexões têm prioridade de execução!**\
Os blocos que têm uma condição definida sempre serão executados primeiro.

**Prioridade de execução de blocos e setas:**\
O **"Start"** o bloco é sempre executado primeiro:

* Primeiro, o **"Start"** bloco com uma condição definida no campo de condição é executado.
* Depois, se existir, o **"Start"** bloco sem condição é executado.

Em seguida, a Conexão do bloco onde o cliente está localizado no momento é executada (se o cliente já estiver no funil).\
Depois:

* outro  **"Start"** bloquear
* O **"Trigger"** bloco

Se nenhuma resposta correspondente for encontrada e o **assistente de IA** estiver ativado, o assistente responderá (se a condição de início permitir).
{% endhint %}

<div data-with-frame="true"><figure><img src="/files/8986b5beb94dd864ec12e95d817092d3433fc187" alt="" width="267"><figcaption></figcaption></figure></div>

**Todos os blocos compartilham uma estrutura unificada:**\
Cada bloco contém uma lista de seções que você pode ativar ou desativar conforme necessário.

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

O **Mensagem** a seção permite que você especifique o texto da mensagem.\
Você pode usar variáveis no texto aplicando o seguinte formato: `#{nome_da_variável}`.

## **Menu pop-up**

Cada bloco tem um menu pop-up que permite executar ações específicas no bloco, incluindo:

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

* **Cópia do bloco:**

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

* **Exclusão do bloco:**

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

* **Copiar o bloco com vinculação**&#x20;

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

* **Mover para outra planilha:**

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

{% hint style="success" %}
**Prioridade de blocos/transições em ordem decrescente:**\
· Início\
· Conexões\
· Gatilho
{% endhint %}

Vamos dar uma olhada mais detalhada em cada tipo de bloco: como criá-los e para que servem.\
Para criar o primeiro bloco, basta clicar duas vezes com o botão esquerdo do mouse na área de trabalho do editor (por padrão, será criado um bloco de Início) ou selecionar o tipo de bloco no menu.

Vamos dar uma olhada mais detalhada em cada um deles.

## **Bloco de chat**

{% hint style="info" %}
Se o bloco não deve conter nenhum texto, insira `#{none}` no campo de resposta (este é o padrão).
{% endhint %}

**Estado do diálogo:** um bloco branco sem condição.\
Você só pode entrar neste bloco por meio de uma seta. Ele se destina a respostas intermediárias, ramificações e ao envio de várias mensagens uma após a outra em intervalos de tempo específicos.

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

## **Bloco Start**

**Condição inicial:** um bloco verde brilhante com a maior prioridade.\
Toda a sequência do bot também pode começar a partir deste bloco. A principal diferença em relação ao **Início do diálogo** bloco é que as condições nesses blocos são verificadas primeiro. Se o cliente inserir uma palavra-chave ou frase deste bloco durante a conversa, ele será redirecionado imediatamente para ele.

Exemplo de configuração da reação do bot a uma saudação do cliente:

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

O cliente receberá a mensagem **"Olá!"** em resposta.

## Bloco de leads

O bloco de leads é um bloco sem condição, na cor vermelha.

O principal objetivo deste tipo de bloco é criar uma solicitação (lead). Ao fazer a transição para este bloco, todos os dados coletados até aquele momento (valores das variáveis) sobre o usuário são enviados ao sistema de CRM, e-mail, WhatsApp pessoal ou Telegram (ou qualquer outro contato especificado nas configurações do projeto) como uma solicitação pronta. Após a transferência, os valores das variáveis da negociação são excluídos do construtor.

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

## Gatilho

**Bloco de gatilho** é um bloco cinza escuro.\
Funcionalmente, é semelhante ao bloco Início, com a única diferença de que o cliente não faz a transição para este bloco.

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

{% hint style="info" %}
A prioridade deste bloco, em comparação com outros blocos condicionais, é a mais baixa — ou seja, ele será acionado por último.
{% endhint %}

## Fallback

**Bloco Fallback** é um bloco cinza. Ele não tem condições como o **Gatilho t** bloco, e não é possível fazer transição para ele.

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

{% hint style="warning" %}
Você pode usar blocos Fallback para criar uma conexão temporizada ou, por exemplo, para validar dados inseridos pelos clientes! Como o usuário não pode fazer transição para esses blocos, ele também não pode sair do fluxo principal.

Os blocos Fallback também podem ser usados para acionar sequências de disparo.
{% endhint %}


---

# 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/types.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.