> For the complete documentation index, see [llms.txt](https://c2dbr-pt.gitbook.io/c2dbr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://c2dbr-pt.gitbook.io/c2dbr/funil-de-vendas-1/chatbot-builder/introducao.md).

# Introdução

Selecione "Criar solução", e depos seleciona "Da lista".  Você também poderá  alterar o nome do seu bot.

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FqNvzKhH9NgDa5p0aCUxr%2Fimage.png?alt=media&amp;token=2609eadd-85e5-4615-87b8-fd3bb94e4d2b" alt=""><figcaption></figcaption></figure>

Depois de criado, você será levado ao editor de cenários. Um cenário é um diagrama do seu bot. Ele consiste em etapas que são conectadas por setas. Cada etapa pode executar ações diferentes, como enviar texto. Um projeto pode ter vários cenários.

### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#overview)Overview

A descrição consiste no local de trabalho (1) onde estão localizadas as etapas, a navegação superior (2), o editor e o fluxo (3).

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2Fp8dql1le178pI39JRcvo%2Fimage.png?alt=media&amp;token=cbf4387c-080e-4f7e-8d1a-c8a2534d8562" alt=""><figcaption></figcaption></figure>

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#workplace)Workplace

Para mover o local de trabalho, mantenha pressionado o botão direito do mouse e mova o cursor. Você também pode usar a roda do mouse para mover a visualização para cima/baixo e SWIFT+Scroll do mouse para mover para a esquerda/direita. Para alterar a escala, use CTRL+Scroll do mouse ou, no mapa, use os botões +/-. Para selecionar um elemento, clique nele com o botão esquerdo do mouse e, para selecionar vários elementos, mantenha pressionado o botão esquerdo do mouse e arraste o quadro.

Para mover um elemento, selecione-o e mova-o mantendo pressionado o botão esquerdo do mouse. Para excluí-lo, clique com o botão direito do mouse nele e selecione “excluir” ou use a tecla de atalho Del. Para copiar um elemento, clique com o botão direito do mouse nele e escolha “Copiar”, depois clique com o botão direito em uma área vazia e escolha “Colar”. Você pode usar as teclas de atalho CTRL+C (copiar), CTRL+V (colar).

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#editor)Editor

O editor aparece à direita do local de trabalho quando um elemento é selecionado ou adicionado. Por exemplo, aqui está o formulário de edição de envio de texto:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FQCj936yfjP1jobmfDDLm%2Fimage.png?alt=media&amp;token=61f3b069-8db7-44ad-9a8b-ba6c54b8b9bc" alt=""><figcaption></figcaption></figure>

Se você não selecionar nada, o editor ficará oculto.

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#minimap)Mapa

<figure><img src="https://marketing.chat2desk.com/docs/static/images/minimap.png" alt=""><figcaption></figcaption></figure>

O mapa exibe o cenário inteiro. O quadro indica a visualização atual. Você pode movê-lo para encontrar a área que deseja. No mapa, você também pode aumentar o zoom e exibir o cenário inteiro.

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#top-nav)Navegação Superior

O menu superior exibe o nome do cenário, seu código e um botão de salvar. Ao clicar com botão esquerdo do mouse no nome do projeto, um menu pop-up aparecerá.

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2F2AhGZv32lxhnbIsNvkUU%2Fimage.png?alt=media&amp;token=037ac0cb-c240-4528-8a46-8b80bb27317e" alt=""><figcaption></figcaption></figure>

No lado direito do menu há botões para definir e gerenciar o cenário:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FvhhhDxgEkOYPnRuW3DYy%2Fimage.png?alt=media&amp;token=bcb17163-89bd-4106-9c5f-79720b4ba811" alt=""><figcaption></figcaption></figure>

Pesquisar por etapas (para uma pesquisa rápida, você pode usar a tecla de atalho Ctrl+F)

Desfazer/refazer última ação&#x20;

Configurações do cenário&#x20;

Gerador de links para iniciar o cenário&#x20;

Salvando o cenário

### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#create-tunnel)Criando Cenários

O local de trabalho contém etapas e links entre elas. Aqui está a aparência de um cenário simples:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FpVTv35jnmiZmMUmqM9ZE%2Fimage.png?alt=media&amp;token=676857a8-7cd1-482e-a1e3-26561ea1f3f1" alt=""><figcaption></figcaption></figure>

O cenário começa a partir do passo “Início” e imediatamente segue a seta deste passo. Se não houver seta, o cenário irá parar imediatamente. O cenário é iniciado por vários eventos, que podem ser editados nas configurações do cenário no menu superior, ou selecione o passo “Início”.&#x20;

&#x20;Para mover uma seta, selecione-a, segure seu final e arraste-a para o nome de outro passo:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FHvjdo7CCcihfreY5kmkq%2Fimage.png?alt=media&amp;token=4dc4af32-9585-40c7-879c-da57b2f4a624" alt=""><figcaption></figcaption></figure>

Para excluir uma seta, selecione-a e pressione Del. Se clicarmos duas vezes na seta, centralizaremos o passo para o qual ela aponta.&#x20;

Quando o cenário tiver se movido para um passo, as ações são executadas imediatamente e, em seguida, a transição para o próximo passo é realizada.&#x20;

Se não houver um próximo passo, o cenário termina automaticamente.

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#add-step)Adicionar Uma Nova Etapa

Para adicionar a próxima etapa, basta clicar no sinal de mais na transição

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FpzBDGWLpGePjDhKOYb09%2Fimage.png?alt=media&amp;token=cf3b4b54-dd76-4915-acdd-23c786214606" alt=""><figcaption></figcaption></figure>

O passo será criado ao lado dessa transição. Se você precisar criar um passo em um lugar diferente, clique no sinal de mais e, sem soltar a tecla, arraste o cursor para o local desejado e solte o botão esquerdo do mouse.

Para adicionar um passo sem um link, clique com o botão direito do mouse e selecione “Adicionar” “Etapa”. <br>

Para renomear um passo, clique duas vezes em seu nome.

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#timeouts)Transição com Intervalo de Tempo

Se você não quiser que o cenário faça a transição imediatamente, você deve especificar um atraso. Para fazer isso, selecione uma etapa no editor e altere este campo:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FSIj4KCWvvPlVvtmZwfH7%2Fimage.png?alt=media&amp;token=71678f88-9671-4023-87be-4da750de315e" alt=""><figcaption></figcaption></figure>

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#actions)Ações Em Uma Etapa

Quando o cenário entra em uma etapa, suas ações são executadas:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FLsKyrAYbx8CwIf5jRLfX%2Fimage.png?alt=media&amp;token=2a4749ba-f91a-40c0-9b0d-0a1a7e3113ab" alt=""><figcaption><p>Neste caso, uma mensagem será enviada e uma tag atribuída</p></figcaption></figure>

As ações são executadas sequencialmente uma após a outra. Para adicionar outra ação, clique no botão “adicionar bloco”:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FNGqMVFEPq1WONi37dAYq%2Fimage.png?alt=media&amp;token=5fcf124e-eed8-418e-8766-f5fccc9dd7b3" alt=""><figcaption></figcaption></figure>

Uma etapa pode ter múltiplas ações.

A ordem das ações pode ser alterada arrastando-as com o mouse enquanto segura o botão esquerdo do mouse. Elas também podem ser arrastadas entre etapas.

[**#**](https://marketing.chat2desk.com/docs/tunnels/introduction/#actions-with-conditions)**Ações com condições**

Você pode adicionar uma condição a cada ação. Se a condição for falsa, a ação será ignorada. Veja como são as ações com condições:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FnsKPH2oYZ9iy9dcWbBpf%2Fimage.png?alt=media&amp;token=63125d80-6796-45b5-aeaf-1c7470106c3e" alt=""><figcaption></figcaption></figure>

Há uma condição especificada para esta ação. Para editá-las, expanda a ação:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2Fjg6psgl9Eeebx7CpyW8I%2Fimage.png?alt=media&amp;token=ee33cd9a-41de-49f7-8457-11fffdcb606b" alt=""><figcaption></figcaption></figure>

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#waiting-for-an-event)Aguardando um evento

Como entender que o usuário digitou algum texto específico? Para fazer isso, há blocos de espera de eventos na etapa. Por exemplo, para verificar se o usuário digitou a palavra “sim”, você precisa adicionar o bloco Correspondência Completa:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FZBn1mDMyDvS2aHmda1rJ%2Fimage.png?alt=media&amp;token=d3e34574-a779-4e02-848c-560dab5d2663" alt=""><figcaption></figcaption></figure>

E nas palavras-chave adicione a frase “sim”. Agora vamos esperar o evento “Message from client”, e essa mensagem deve seguir um determinado formato. Esta é a aparência da etapa de espera por uma mensagem recebida:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FRe4eMeWxrRotfo0IdC4c%2Fimage.png?alt=media&amp;token=bd30b6ac-36a6-47e9-ba34-d26b2c3574a3" alt=""><figcaption></figcaption></figure>

O evento será disparado somente se o cenário estiver em execução e estiver em uma etapa que esteja aguardando o evento (nesse caso, a Etapa Inicial). Observe que o tempo limite da etapa é exibido como "24 horas" - este é um tempo limite automático para etapas que estão aguardando um evento.&#x20;

Se nenhum evento ocorrer durante esse tempo, o cenário parará de esperar por eles. Para definir seu próprio tempo limite, defina-o nas configurações da etapa. Uma etapa pode ter vários eventos.&#x20;

Depois que um evento é disparado, o cenário faz a transição para esse evento. Nesse caso, o evento "Sim" não é associado a outra etapa, então o cenário terminará. Vamos adicionar um manipulador de eventos:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2Fh65O7gidKZz6UGAo3vAK%2Fimage.png?alt=media&amp;token=081b124c-af4e-45ef-8041-c0e059f05e79" alt=""><figcaption><p>Aqui adicionamos outra opção “Não”, bem como o tratamento da mensagem “Sim”.</p></figcaption></figure>

Os eventos podem ser movidos segurando o botão esquerdo do mouse e, para renomeá-los, clique duas vezes em seu nome.

#### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#global-events-handling)Tratamento de Eventos Globais

Os eventos são processados ​​se o cenário estiver em execução e estiver na etapa correta. No entanto, pode ser necessário processar eventos, esteja o cenário em execução ou não. Há uma ramificação global para isso. Para tornar uma ramificação global, selecione a etapa com eventos e marque o sinalizador de ramificação global nas configurações. A ramificação global é marcada com este símbolo:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2Fs6AFWT4eBCqgcV2EsSdH%2Fimage.png?alt=media&amp;token=8afac132-3359-4f06-adc3-9bba43cd8434" alt=""><figcaption></figcaption></figure>

Se a ramificação estiver assim marcada, iniciaremos o cenário a partir do evento especificado, caso ele ocorra e o cenário ainda não tenha sido iniciado. Dessa forma, você pode processar comandos de bot, como este por exemplo:

<figure><img src="https://marketing.chat2desk.com/docs/static/images/global-events-handling-2.png" alt=""><figcaption></figcaption></figure>

Estatística de Etapa

A etapa possui uma caixa de seleção *Mostrar* esta etapa no relatório:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2F6Fer3zgJElkBK8kxPsZO%2Fimage.png?alt=media&amp;token=fa472dc2-d8c6-47a3-bd2a-ac597ce1e1f5" alt=""><figcaption></figcaption></figure>

Se você marcar, o painel desta etapa exibirá estatísticas: quantas vezes a etapa foi ativada e quantos usuários únicos a visitaram.&#x20;

No título da etapa no relatório, você pode renomear a etapa, pois por padrão o nome da etapa estará lá.

### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#buttons)Botões

Botões só podem ser anexados a uma etapa com uma mensagem.&#x20;

Para anexar botões a uma mensagem, você precisa adicionar os blocos apropriados na etapa com o envio da mensagem:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FUr3YNQYBd0o5PjfmvIUV%2Fimage.png?alt=media&amp;token=f680884d-37c8-4a62-8cbc-1c197c03a0da" alt=""><figcaption></figcaption></figure>

Um botão embutido é anexado à mensagem, um botão normal é exibido abaixo da linha de entrada.

É assim que o passo com o botão se parece:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FwUoz8wvgl60auTN19dyo%2Fimage.png?alt=media&amp;token=aff672e8-763d-4c92-8507-3f77ca7cd64c" alt=""><figcaption></figcaption></figure>

Palavras-chave alternativas podem ser anexadas ao botão para que diferentes opções de resposta possam ser manipuladas para mensageiros que não suportam botões. Para fazer isso, insira uma ou mais palavras-chave (cada uma em uma linha separada ou por uma barra vertical “|”) neste campo:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FybVr4xlGcs653Um4QIVm%2Fimage.png?alt=media&amp;token=f5bac787-21fe-46eb-aee8-7b3fe6dcf7fb" alt=""><figcaption></figcaption></figure>

Os botões só podem ser adicionados a uma etapa com uma mensagem, pois eles são enviados apenas com a mensagem. Quando uma postagem tem condições, os botões não serão enviados a menos que as condições sejam atendidas.

[**#**](https://marketing.chat2desk.com/docs/tunnels/introduction/#inline-url)**URL Incorporado**

Você pode anexar um link a uma mensagem. Para fazer isso, adicione o bloco "URL em linha". Nas configurações, você precisa preencher o endereço do site para o qual o usuário será levado:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2F0BxB2LZjEYVpqRacZnkZ%2Fimage.png?alt=media&amp;token=6a469b72-8831-4d9f-8cfe-eebfc5a77e28" alt=""><figcaption></figcaption></figure>

Nós suportamos dois tipos de botão: com e sem substituição. Com um link de substituição, você pode rastrear o clique do usuário no seu link, mas o link em si é substituído por algo como <https://mssg.su/tb/AbCDEfGH>.

Ao adicionar um link com uma definição de transição, o botão em si deve ser associado a uma etapa, caso contrário, o cenário será encerrado quando o link for aberto!

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FUhUzMvj0RiMxNN1pBbyh%2Fimage.png?alt=media&amp;token=717eddc0-23bd-4611-ab78-02c85e9cd09c" alt=""><figcaption><p>É assim que se parece um tratamento típico de um usuário clicando em um link</p></figcaption></figure>

Um link incorporado sem uma definição de transição é enviado como está e não é possível saber se o usuário clicou ou não.

### [#](https://marketing.chat2desk.com/docs/tunnels/introduction/#conditions)Condições

Para permitir que o cliente entre em diferentes áreas do cenário com base em alguns valores, você pode adicionar uma condição. Para fazer isso, abra o menu de adição de bloco e selecione Condição:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2Fwvu2vqAjkCvPMMrrgMIz%2Fimage.png?alt=media&amp;token=8209194e-cdc9-4ad6-b8bb-6807a38b6cb6" alt=""><figcaption></figcaption></figure>

É assim que a etapa com a condição se parece:

<figure><img src="https://617700087-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1mdVFjIyp8q7yeGIckbq%2Fuploads%2FMkcKNPS8NgZsZ7C9z6xs%2Fimage.png?alt=media&amp;token=3c1d07d3-4c33-460e-a5b4-fc8ddfcbe781" alt=""><figcaption></figcaption></figure>

Quando o cenário chega a uma etapa com uma condição, procuramos a primeira condição verdadeira na ordem em que são especificadas. Se for encontrada, a transição é realizada exatamente de acordo com essa condição. Se nenhuma das condições for verdadeira, a transição é realizada de acordo com o bloco Outro.&#x20;

As condições podem ser movidas dentro de uma etapa, bem como movidas para outras etapas, segurando o botão esquerdo do mouse. A condição pode ser nomeada clicando duas vezes no título.