# Configurações do projeto

Nas configurações do projeto, você pode selecionar notificações recebidas, configurar o trabalho com funis e, em seguida, definir variáveis e constantes, renomear o projeto e muito mais.

<figure><img src="/files/45a96ba3b56c79f36318873758308fa272758d2b" alt="" width="210"><figcaption></figcaption></figure>

Instrução mencionada abaixo.

## Configurações principais

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

Nas configurações principais do projeto, o usuário pode alterar:

* o nome do projeto;
* fuso horário;
* o proprietário do projeto;
* definir o domínio para links no bot:

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

Você precisará instalar seu próprio domínio se for necessário que o link proxy esteja no seu domínio, e não no domínio da Mavibot. Esta é uma configuração opcional.

URL do webhook

* É necessário para receber eventos de serviços de terceiros.

Você também pode ativar caixas de seleção nas configurações principais do projeto:

<figure><img src="/files/6affd0295e4de43ccf32b8fe7b9fe0e2b7ed13d3" alt=""><figcaption></figcaption></figure>

* Aceitar automaticamente leads para a primeira etapa do funil\
  Esta caixa de seleção gerará imediatamente cards de transação na primeira etapa do funil no MaviCRM.
* Proibir operadores de enviar arquivos\
  Após selecionar esta configuração, os funcionários do seu projeto com a função de Operador (ou outra função configurada manualmente) não poderão enviar arquivos nos diálogos.
* Clientes aguardando resposta ficam sempre no topo \
  Exibirá no topo de toda a lista os clientes para os quais você ou seus funcionários ainda não responderam.
* Não verificar o formato dos parâmetros post-json\
  Para configurações no bot
* O bot está ligado\
  Uma caixa de seleção para ligar/desligar o bot em um projeto

## Callbacks

Nas configurações do projeto, você pode definir quais callbacks deseja receber no MaviBot:

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

{% hint style="success" %}
Callback é uma notificação do sistema que ajudará você a acompanhar eventos no Mavibot sem precisar verificar toda vez as listas, rótulos e funis no CRM, o que economizará bastante o seu tempo.
{% endhint %}

{% hint style="info" %}
Nesta seção, as notificações do sistema são configuradas apenas a partir das seções do Mavibot. Para ver quais callbacks chegam, por exemplo, de sistemas de pagamento, mensageiros e outras integrações, você precisa ler o artigo de documentação correspondente.
{% endhint %}

&#x20;é possível configurar callbacks para notificações:

* Adição/remoção de listas e rótulos
* Ações com tarefas: criar, excluir, editar e concluir

Por exemplo, ao criar uma tarefa vinculada a um cliente específico, uma mensagem com o texto aparecerá na seção "Clientes" do diálogo com ele: new\_task\_added\_callback task\_id:#{task.id}, task\_name:#{task.name}

<figure><img src="/files/1eff92bf7a6ced336db176ede0358ce064e2cb17" alt="" width="375"><figcaption></figcaption></figure>

E ao editar uma tarefa vinculada a um cliente específico, um comentário aparecerá no diálogo com o cliente com o texto: "A tarefa foi editada" #{current\_user.display\_name}: edit\_task\_callback task\_id:#{task.id}, task\_name:#{task.name}"

<figure><img src="/files/3831f851651ba9258c677a40d162df09a2ab1bcd" alt="" width="375"><figcaption></figcaption></figure>

* Alteração do responsável pelo cliente

O callback inclui o ID do negócio, bem como o nome do responsável para quem seu funcionário anterior foi substituído:

<figure><img src="/files/fb8802465c540de3dd7c50cd32b31a319230adc9" alt="" width="375"><figcaption></figcaption></figure>

* Exclusão do negócio

Para ver todas as ações no CRM, monitore também a exclusão de transações nos seus funis para não perder nada importante:

<figure><img src="/files/bd6a68b42b4433199d929b923a6e9b6010936ed0" alt="" width="375"><figcaption></figcaption></figure>

* Arrastar e soltar negócios para um estado do sistema

Existem estados do funil do sistema para os quais uma negociação pode ser movida no MavibotCRM:

É possível configurar o envio de callbacks durante o arrastar e soltar de negócios por estado: "excluir negócio", "negócio concluído", "negócio bem-sucedido", "arquivar". Então, em um diálogo com o cliente, você receberá uma notificação do seguinte tipo:

<figure><img src="/files/e6f8b0193291f357653cc858afa8010a51784f7e" alt="" width="375"><figcaption></figcaption></figure>

### Configurando callbacks durante a transição entre etapas do CRM

<figure><img src="/files/5d66e5d84638734fb72489c783b80b66e234c685" alt=""><figcaption></figcaption></figure>

Depois de clicar em "Configurações de callback para transições de etapa do CRM", uma janela modal se abre com todos os funis existentes no projeto:

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

Essa configuração ajudará a ativar o bot durante a troca do cliente para um determinado estado do funil. Para isso, basta selecionar o funil inteiro (então qualquer troca do negócio do cliente pelo funil ativará o bot) ou apenas uma troca para um determinado estado:

<figure><img src="/files/ed6cf20f90c6ee7f1f67ff152dfc0df7bbfa6cd5" alt="" width="375"><figcaption></figcaption></figure>

Agora, durante as mudanças de status do negócio (automaticamente ou manualmente), é gerada uma notificação de qualquer lugar do site que possa acionar o bot.

{% hint style="info" %}
A notificação se parece com isso: crm\_state\_changed Nome do funil:Nome da etapa
{% endhint %}

A variável callback\_query\_id também aparecerá no cartão do cliente, que armazenará o identificador da transação para a qual a notificação foi enviada:

<figure><img src="/files/4f7585b6cda992921ff4e64c1fb13a54edc6b71a" alt="" width="375"><figcaption></figcaption></figure>

Para acionar o bot para este evento, você deve especificar o texto da notificação no campo Condição da seta ou em qualquer bloco com condição (um bloco de verificação de condição primária, não uma condição de estado).

## Constantes

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

É necessário considerar os limites de variáveis e constantes no projeto:

* O número máximo de variáveis de modelo é 100;
* O nome de uma variável de modelo não pode exceder 100 caracteres;
* O número máximo de constantes do projeto é 50;
* O nome da constante não pode exceder 100 caracteres;
* O valor de uma constante não pode exceder 5000 caracteres.
  {% endhint %}

Uma constante de projeto é uma variável constante e imutável. Por exemplo, você pode precisar dela para trabalhar com pagamentos em um bot.

<figure><img src="/files/9c90a21be2d01950a75bcb52e40522de7af5412b" alt="" width="563"><figcaption></figcaption></figure>

Para adicionar constantes do projeto, clique no ícone de lápis. Em seguida, uma janela modal será aberta onde você poderá inserir o nome da variável e seu valor:

<figure><img src="/files/bab1f70469a56a53a2684ea88cea1ea13295104f" alt="" width="375"><figcaption></figcaption></figure>

Depois, você só precisa inserir uma variável:

<figure><img src="/files/891ad5174e1ac62393bba2a3bf6fa1e8c7d43396" alt="" width="375"><figcaption></figcaption></figure>

Então, em um diálogo com o cliente, o bot obtém os valores da constante do projeto:

<figure><img src="/files/c0c43e7311e112b7077f015a1a079f56d920a0a5" alt="" width="375"><figcaption></figcaption></figure>

## Variáveis

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

É necessário considerar os limites de variáveis e constantes no projeto:

* O número máximo de variáveis de modelo é 100;
* O nome de uma variável de modelo não pode exceder 100 caracteres;
* O número máximo de constantes do projeto é 50;
* O nome da constante não pode exceder 100 caracteres;
* O valor de uma constante não pode exceder 5000 caracteres.
  {% endhint %}

As variáveis atribuídas nas configurações do projeto também podem ser usadas dentro do seu chatbot (incluindo um [chatbot com IA](/doc/pt/chatbot/ai/online-booking.md)).&#x20;

<figure><img src="/files/31740d60fb275a0b8fe7708ca1ed5e1a422166ed" alt=""><figcaption></figcaption></figure>

As variáveis atribuídas nas configurações do projeto também podem ser usadas dentro do seu chatbot (incluindo um chatbot com IA).

{% hint style="warning" %}
Diferença entre variáveis e constantes

* As variáveis podem ser alteradas por meio de bots, enquanto você só pode obter um valor de uma constante.
* O valor das variáveis é o mesmo para todos os usuários. Isso significa que, se você alterar o valor de uma variável por meio do bot, ele mudará para todos os clientes, inclusive nas configurações do projeto. Você não pode alterar uma constante assim.
* O valor da constante só pode ser alterado de forma única para um cliente; respectivamente, nas configurações do projeto, a constante permanecerá inalterada com o valor definido anteriormente.
* Se você acessar uma variável no bot usando a construção "project.", você pode alterar o valor da variável.
  {% endhint %}

{% hint style="success" %}
Um exemplo claro de como trabalhar com uma variável por meio de um bot e da construção do projeto. você pode ler no artigo "[Chatbot com IA para agendamento online](/doc/pt/chatbot/ai/online-booking.md)".&#x20;
{% endhint %}

### Como atribuir variáveis/constantes corretamente nas configurações do projeto

{% hint style="danger" %}
ATENÇÃO!

Você não pode usar interpolação de variáveis no valor de uma variável/constante NAS CONFIGURAÇÕES DO PROJETO!

Interpolação é a atribuição de uma variável a outra por meio da construção #{}.
{% endhint %}

<mark style="color:vermelho;">**INCORRETO:**</mark>

<figure><img src="/files/7e3bab5c8472f0fefd0e5382c46b4f03bdaecdaf" alt="" width="375"><figcaption></figcaption></figure>

<mark style="color:verde;">**CORRETO:**</mark>

Ao atribuir variáveis nas configurações do projeto, você pode usar valores diferentes:

<figure><img src="/files/533412da2f9ab3df751c491f5afd66b95d838133" alt="" width="375"><figcaption></figcaption></figure>

Por exemplo, as variáveis da captura de tela acima foram armazenadas em cache no projeto via bot usando blocos construtores e funções instaladas:

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

{% hint style="info" %}
A função get\_info\_for\_booking() só funciona quando a seção "Serviços" está configurada para agendamento online e usa valores para intervalos disponíveis de agendamento livre.
{% endhint %}

Observe que a variável está armazenada em cache nas configurações do projeto por meio da construção "project.":

<figure><img src="/files/bb6571d215e067d4f5719cda7a6e68678362eefb" alt="" width="563"><figcaption></figcaption></figure>

Você também pode adicionar uma variável nas configurações do projeto clicando no ícone de lápis:

<figure><img src="/files/27271a091036f8a554a282cded6dc98d0d843bba" alt=""><figcaption></figcaption></figure>

Depois disso, abre-se uma janela modal com uma lista existente de variáveis, onde você precisa clicar em "Adicionar variável":

<figure><img src="/files/557a0b2e13c8a43b34567f70ffe1de1ed26799b8" alt="" width="375"><figcaption></figcaption></figure>

Além disso, você pode definir o nome da variável como preferir, [evitando nomear variáveis do sistema](/doc/pt/chatbot/functions/variaveis.md#how-to-work-with-variables)

<figure><img src="/files/9b5c689b98c490ff82b59856bf1faf07c299459e" alt="" width="375"><figcaption></figcaption></figure>

### Modelos de variáveis

Usando a função "Modelos de Variáveis do Projeto", você pode montar variáveis rapidamente, independentemente de seus tipos.

Para montar uma variável usando um modelo, clique no botão de mesmo nome:

<figure><img src="/files/ea3eb39fffbbcbfa3066389dc2be35c5b66945d3" alt="" width="375"><figcaption></figcaption></figure>

Você verá uma janela modal na qual haverá um campo vazio para o nome da variável e uma lista suspensa com o tipo:

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

Se você selecionou o tipo de variável "Lista", então pode especificar possíveis valores para a variável.:

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

Para adicionar vários valores:

Passo 1: Insira o nome da variável;

Passo 2: Insira o valor 1 para a variável;

Passo 3: clique no sinal de mais na linha com o valor: após clicar no sinal de mais para um dos valores da variável, aparecerá uma barra abaixo do campo com os dados que você inseriu para a variável:

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

Passo 4. Insira o próximo valor da variável e pressione o botão de mais novamente: você deve clicar no botão de mais após cada vez que inserir um dos valores da variável.

Passo 5. Clique em "Criar": então a variável será adicionada na parte inferior da janela modal:

<figure><img src="/files/14e7d721987cf0df59f0e3ce6158589cf37d7f7c" alt=""><figcaption></figcaption></figure>

## Mensagens

Esta seção aborda todos os pontos necessários ao trabalhar com chatbots:

<figure><img src="/files/7fcaf06214b0d19f1760e4d953db1fed816ce685" alt="" width="375"><figcaption></figcaption></figure>

1. Você pode informar seu próprio endereço/vários endereços de e-mail para receber pedidos/solicitações no seu e-mail sem perder um único evento.
2. Se necessário, há uma configuração de resposta automática à primeira mensagem do usuário em uma janela de chat online ou em um mensageiro com botões.

{% hint style="info" %}
Para mais informações, veja o artigo [A primeira mensagem nos mensageiros](/doc/pt/chatbot/mensageiros/message.md)&#x20;
{% endhint %}

3. Você também pode se prevenir para que o bot nunca pare: defina o texto da mensagem se o bot não souber a resposta do usuário.
4. Além disso, ao ativar as caixas de notificação, você poderá ver os clientes que escreveram para você no bot, mesmo que você esteja atualmente em outro projeto do Salebot.

### Mensagens duplicadas

Além disso, nas configurações do projeto, na seção Mensagens, você pode definir mensagens duplicadas para o e-mail dos seus alunos e clientes:

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

Se um aluno/cliente lhe escrever em um chat online e, após a mensagem, ela não for lida por ele, então, quando essa configuração estiver ativada, uma mensagem será enviada ao aluno/cliente após um período especificado.

{% hint style="warning" %}
Importante! Para que esse recurso funcione, você precisa de um bot de e-mail conectado e autorizado.
{% endhint %}

{% hint style="info" %}
Como conectar um bot de e-mail foi descrito no artigo "[Envios de e-mail](/doc/pt/envios/campanhas-de-e-mail.md)". — inserir link
{% endhint %}

Para que a duplicação de e-mail funcione, é necessário definir o intervalo após o qual a mensagem não lida do aluno/cliente será duplicada para o e-mail:

<figure><img src="/files/e134b320e8a6c5e1b3e50d7648b9b6a3ababe0c9" alt="" width="375"><figcaption></figcaption></figure>

Se vários bots de e-mail estiverem conectados ao projeto, então você pode escolher de qual deles a mensagem duplicada será enviada:

<figure><img src="/files/79191b1a3bf0c606d334eed19af871cf3fe591d9" alt=""><figcaption></figcaption></figure>

#### Tutorial em vídeo

{% embed url="<https://youtu.be/Teb_onsWUYA>" %}


---

# 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/us/admin/settings.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.