> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/comece-rapido/leadzy-tutorial/1.-new-bot-new-block.md).

# 1. Novo bot, novo bloco

{% hint style="warning" %}
Para começar, você precisa de uma conta da Chatlayer. **Ainda não tem uma conta?** [Crie uma conta de teste aqui](https://chatlayer.ai/try-now/). Está tendo problemas com sua conta? Entre em contato com nossa equipe de suporte em <support@chatlayer.ai>.
{% endhint %}

Neste capítulo, vamos construir o início da conversa.

<figure><img src="/files/07995e5beace13d817187adfa924d44743b49878" alt="" width="375"><figcaption><p>O que vamos construir na Lição 1 do Leadzy.</p></figcaption></figure>

## Etapa 1: Crie um novo bot

Para criar um novo bot:

1. Ir para [app.chatlayer.ai](http://app.chatlayer.ai) e faça login usando suas credenciais.
2. No canto superior direito da tela, clique em **Novo bot** botão.
3. Digite *Leadzy* como nome, para que você possa encontrá-lo facilmente novamente.
4. Selecione **Inglês** como seu idioma principal.

{% hint style="success" %}
A [idioma principal](https://docs.chatlayer.ai/understanding-users/multilanguage-bots#primary-language-vs.-secondary-languages) é o idioma que seu bot usará. Se você quiser que seu bot seja multilíngue, poderá alterar isso depois.
{% endhint %}

<figure><img src="/files/a3d0210e217f9f2c5cb00c4784f880327971260e" alt=""><figcaption><p>Crie um novo bot e chame-o de Leadzy.</p></figcaption></figure>

5. Clique em **Criar**.

Seu bot abre, mostrando:

* Seu bot [canvas](https://docs.chatlayer.ai/bot-answers/bot-canvas) no meio da tela, que é uma representação visual da arquitetura do seu chatbot. Vários [blocos padrão de conversa](https://docs.chatlayer.ai/bot-answers/dialog-state#default-blocks) aparecem nesta tela, mas não vamos nos preocupar com isso agora.
* A [**Fluxos**](https://docs.chatlayer.ai/bot-answers/bot-canvas/how-to-organize-your-flows) de conversa à esquerda.
* O menu geral do seu chatbot na extrema esquerda.

<figure><img src="/files/9c03beda30af782746b4dbcedbd55ec91dc69b80" alt=""><figcaption><p>A visualização da tela quando você abre seu chatbot.</p></figcaption></figure>

{% hint style="info" %}
Para navegar pela tela, você pode ampliar ou reduzir usando a roda de rolagem ou o trackpad. Você também pode clicar e arrastar para se mover pela árvore de blocos.
{% endhint %}

{% hint style="success" %}
**Fluxos** são uma forma de agrupar blocos que tratam do mesmo tópico ou caso de uso. Saiba mais sobre eles [aqui](https://docs.chatlayer.ai/bot-answers/bot-canvas/how-to-organize-your-flows).
{% endhint %}

Seu chatbot foi criado com sucesso!

## Etapa 2: Edite um bloco de Mensagem

Agora, é hora de fazer seu chatbot dizer algo.

{% hint style="success" %}
Um **Mensagem** **bloco** é um tipo de mensagem em que seu bot vai solicitar algo ao usuário. Saiba mais sobre blocos [aqui](https://docs.chatlayer.ai/bot-answers/dialog-state).
{% endhint %}

### Edite o bloco de Introdução

Para começar, vamos modificar seu bloco de introdução.

{% hint style="success" %}
A **Introdução** bloco é um bloco padrão que serve como a primeira mensagem que seus usuários verão. É nele que seu bot se apresenta e explica suas funcionalidades. As introduções são cruciais para definir expectativas adequadas para o bot.
{% endhint %}

Para editar o **Introdução** bloco:

1. Na sua tela, clique em **Introdução** bloco.

<figure><img src="/files/1e48b60428ba43f2d89777c3d54cd18f917630dd" alt=""><figcaption><p>Seu bloco de Introdução é onde a conversa começa. Ele vem com uma mensagem padrão.</p></figcaption></figure>

2. O bloco se abre no lado direito da tela. Em **Mensagem de texto**, exclua a mensagem padrão e substitua por:

*Olá! Que sorte a sua, hoje temos 15% de desconto em toda a seleção! Você quer receber um código de desconto por e-mail?*

<figure><img src="/files/b0d616a9be3d9d73c9d51e6b2f228fc666ff063f" alt=""><figcaption><p>Edite a mensagem dentro do seu bloco de Introdução.</p></figcaption></figure>

3. Clique em **Salvar**.

Seu bloco de Introdução agora foi modificado e você pode vê-lo na sua tela.

<figure><img src="/files/f3cd1f259204432dbd40ab9e2d0c673cc98f7fa0" alt=""><figcaption><p>Seu bloco de Introdução após a modificação.</p></figcaption></figure>

### Adicionar mensagens alternativas

Para tornar a conversa natural, queremos ter diferentes maneiras de transmitir a mesma mensagem de introdução.

{% hint style="success" %}
Uma mensagem alternativa é uma mensagem de texto que alternará aleatoriamente com outra, para que a conversa pareça mais humana.
{% endhint %}

Para adicionar mensagens alternativas a uma mensagem do bot:

1. Abra seu bloco de Introdução clicando nele.
2. Em **Mensagem de texto**, clique em **+** **Adicionar mensagem alternativa**, e cole a seguinte mensagem:

   *Olá! Boas notícias! Estamos oferecendo atualmente 15% de desconto em toda a nossa seleção! Você gostaria de receber um código por e-mail?*
3. Faça o mesmo com outra mensagem alternativa:

   *Notícia empolgante! No momento, temos uma oferta especial de 15% de desconto em toda a nossa seleção! Você teria interesse em receber um código de desconto por e-mail?*

<figure><img src="/files/34ce77c0e36401a4be3378be53c9d95cc5ad55f4" alt=""><figcaption><p>Adicione mensagens alternativas.</p></figcaption></figure>

4. Clique em **Salvar**.

Vamos agora ver como podemos testar se o bot se comporta como esperado.

## Etapa 3: Teste seu bot

A Chatlayer oferece uma maneira simples de testar seu bot toda vez que você faz uma modificação.

### Execute testes no Emulador

Para testar seu bot:

1. Clique no botão de reprodução no canto superior direito da tela do seu bot.

<figure><img src="/files/41af53805bf316b999c9f62533366218c58c6a42" alt="" width="225"><figcaption><p>Teste seu bot.</p></figcaption></figure>

2. Um **Teste seu bot** a janela aparece no lado direito. Ela inicia automaticamente a conversa, o que significa que o bot solicitará seu **Introdução** bloco. A partir daí, digite algo como resposta, por exemplo ‘*Sim, eu adoraria receber um código de desconto*’.
3. Pressione Enter no teclado para enviar sua mensagem.

<figure><img src="/files/7f89e8fa0e7b8512d6fe0c67cd7f4b5e7df015ea" alt="" width="285"><figcaption><p>Teste seu bot com esta frase. Este é o resultado esperado.</p></figcaption></figure>

4. O bot não entendeu você — e isso é absolutamente normal! Por enquanto, tudo o que ensinamos ao nosso bot foi dizer uma saudação.
5. Clique no botão Reiniciar conversa no canto superior direito da janela de teste.

<figure><img src="/files/072e5fb2e13f1ada15963d3c81092890f3e033e2" alt="" width="291"><figcaption><p>Reinicie a conversa para executar um novo teste.</p></figcaption></figure>

6. Perceba que a mensagem de Introdução exibida agora é diferente. Isso acontece porque mensagens alternativas foram adicionadas a ela, e elas são exibidas de forma aleatória.

<figure><img src="/files/740b4ad907ef0e3f9a5be3d30a9971ca14b04ee9" alt="" width="355"><figcaption><p>Ao executar vários testes, você notará que as mensagens se alternam porque você adicionou mensagens alternativas.</p></figcaption></figure>

Você acabou de executar um teste com sucesso: seu bot tem o comportamento esperado!

### Execute testes no sandbox do WhatsApp

Dada a alta demanda por WhatsApp entre nossos clientes, a Chatlayer oferece um método fácil para testar suas conversas diretamente na plataforma.

{% hint style="info" %}
Por que executar testes em um sandbox do WhatsApp? Cada canal tem suas [limitações](https://docs.chatlayer.ai/channels/multi-channel#channel-comparison), portanto, você quer garantir que seus testes rodem sem problemas nos canais que você escolher.
{% endhint %}

Para executar testes dentro do sandbox do WhatsApp:

1. Abra o seu **Teste seu bot** janela.
2. No canto superior esquerdo da janela de teste, selecione **sandbox do WhatsApp**.

<figure><img src="/files/e245c1817214cd26a285fa82908dc9328623a877" alt=""><figcaption><p>Teste seu bot no WhatsApp usando o sandbox do WhatsApp.</p></figcaption></figure>

3. Um código QR é exibido na tela, com um link abaixo. Ou:
   * Escaneie o código QR com seu celular, para que o app do WhatsApp no seu telefone seja aberto.
   * Clique no link abaixo do código QR, para que você possa abrir o app web do WhatsApp.
4. O que quer que você escolha, clique em **Continuar** para conversar.
5. Envie a mensagem que começa com ‘join’ e que já está preenchida no campo de texto.
6. Você receberá uma confirmação de que está tudo pronto no sandbox. Diga algo ao bot para iniciar a conversa como você a idealizou.

<figure><img src="/files/e768389a9ff41bf1523a8c3581e6b46911afe188" alt=""><figcaption><p>Siga estas etapas para iniciar uma conversa no sandbox do WhatsApp.</p></figcaption></figure>

Nosso bot também está funcionando no WhatsApp, oba!

## Recapitulação da Lição 1

Parabéns, você acabou de dar seus primeiros passos! Nesta lição, você aprendeu a:

* [ ] Criar um novo bot na página inicial da Chatlayer.
* [ ] Editar um bloco de Mensagem e adicionar mensagens alternativas a ele para que pareça natural. Para isso, usamos como exemplo o bloco padrão de Introdução.
* [ ] Testar suas alterações na janela de Teste.
* [ ] Executar testes no WhatsApp usando o sandbox do WhatsApp.

## O que vem a seguir

Em seguida, vamos ensinar seu bot a entender as respostas dos usuários.

{% content-ref url="/pages/dcd818491e7e0da94e733a19a7570c7ec0a0be0c" %}
[2. Entenda seus usuários](/chatlayer-documentation-pt-br/comece-rapido/leadzy-tutorial/2.-understand-your-users.md)
{% endcontent-ref %}

## 💬 Feedback

{% hint style="warning" %}
Seu feedback sobre o tutorial significa muito para nós! Por favor, nos diga o que você acha por meio do [este formulário curto.](https://forms.office.com/Pages/ResponsePage.aspx?id=ropROyGJe0qEl2GddWziDlEYn6XpsIRDjnCtdRk8L21UMFZMMlAzN0tHOTI4UjMxVTgzTVAwTE5aOCQlQCN0PWcu)
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/comece-rapido/leadzy-tutorial/1.-new-bot-new-block.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.