# Criando um chatbot

A automação no atendimento ao cliente se tornou uma das estratégias mais eficazes para melhorar a experiência do usuário, reduzir o tempo de resposta e otimizar recursos. Na **plataforma**, é possível criar **chatbots personalizados** para responder automaticamente perguntas frequentes, direcionar atendimentos e garantir agilidade no contato com seus clientes, tudo isso integrado aos canais oficiais como **WhatsApp**, Instagram e Facebook.

Neste artigo, você vai aprender como configurar um chatbot na **plataforma** de forma prática e eficiente.

{% hint style="success" %}
**Pré-requisitos:**

* Uma conta ativa na **plataforma**;
* Permissão de administrador para configurar o chatbot;
* Um **canal de atendimento** configurado (WhatsApp, Instagram ou Facebook);
* Mapeamento das perguntas e respostas que deseja automatizar;
* Clareza sobre o objetivo do bot (ex: triagem de atendimento, envio de informações, direcionamento por setor).
  {% endhint %}

**Passo a passo para criar um chatbot na plataforma**

**Passo 1:** No painel da **plataforma**, clique no menu **"Apps**" e em seguida selecione **"Chatbot"**.

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

**Passo 2**: Defina o **tipo de Chatbot** (Atendimento ou Automação), em seguida clique em “+ **Novo "** para iniciar a criação de um fluxo.

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

**Passo 3:** Escolha um nome que represente a função do bot (ex: "Bot de Suporte", "Bot Comercial").\
Selecione o canal no qual o **chatbot** será ativado (WhatsApp, Instagram ou Facebook), e qual a equipe padrão onde todas as conversas que se iniciarem serão criadas Clique no botão **"salvar".**

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

**Passo 4:** O sistema vai apresentar a tela de edição do seu **chatbot**. No centro da tela serão exibidos os componentes de execução do chatbot, à direita será exibida a apresentação do seu chatbot, ou seja, como ele será exibido no **WhatsApp** do seu cliente.

Abaixo, no centro da tela, tem um botão de **salvar as alterações**. Do lado esquerdo tem um botão para **testar** e do lado direito um botão para **publicar a versão em produção**.

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

{% hint style="danger" %}
**Observação**:

* O botão **"Testar"** deve ser utilizado para validar o funcionamento do chatbot **antes da publicação oficial**. Ao realizar essa publicação de teste, o chatbot **não ficará visível no canal de atendimento escolhido**, ou seja, apenas você poderá testá-lo.
* Ao clicar em **"Testar"**, a plataforma gera um **código com hashtag** exclusivo. Esse código, ao ser enviado no canal de atendimento (como o WhatsApp, por exemplo), **ativa o chatbot em modo de teste**, permitindo que você simule a experiência do cliente e avalie o fluxo ainda em fase de desenvolvimento.
* Para isso, é necessário clicar em **"Testar"** e, em seguida, **confirmar a ação clicando em "Publicar alterações"** na janela (modal) exibida na tela.
* Quando o seu chatbot estiver pronto para uso, clique no botão **"Publicar versão"**, localizado no canto inferior direito da tela. Ao realizar essa ação, o chatbot será disponibilizado oficialmente e, caso já esteja associado a um canal de atendimento, **passará a responder automaticamente às conversas recebidas**\\
  {% endhint %}

**Passo 5**: Agora é o momento de definir as **instruções que o seu chatbot deverá executar**. Para isso, clique no botão **“+”** e selecione uma das opções disponíveis a seguir:

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

* **Mensagem: i**nstrução que vai disparar uma mensagem tão logo chegue a vez dela no fluxo do seu chatbot. Essa mensagem pode ser uma mensagem de texto apenas, um áudio, uma mensagem de texto com imagem / vídeo ou pode ser um documento um PDF. Durante a execução o chatbot vai exibir essa mensagem e vai passar para a próxima instrução.

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

* **Modelo de mensagem:** você pode escolher uma mensagem do tipo marketing ou do tipo utilidade que tenha sido previamente cadastrada e aprovada pela meta, e enviar para o seu contato. Esse tipo de mensagem é imprescindível que seja utilizado quando você estiver configurando um chatbot de automação, por exemplo. Em uma campanha ou em uma sequência como não se sabe se a janela de 24h estará aberta no momento do disparo, o ideal é que coloque uma mensagem modelo, assim garantirá que essa mensagem chegue até o contato.

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

* **Pergunta:** a pergunta pode ser apenas uma pergunta com texto, com menu de botões ou uma pergunta com uma lista de opções. Independente do modelo que você selecionar o sistema vai ficar aguardando a resposta do seu contato. Assim que o contato responder o sistema vai executar o próximo comando da configuração.Uma pergunta ainda pode ser configurada para:

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

* **Resposta inválida**: a pergunta é com botões ou lista, por exemplo, e seu contato equivocadamente encaminhar um áudio ou um texto. Neste caso é possível configurar o envio de uma mensagem alertando o contato.

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

* **Tempo de espera**: configure o tempo de espera a ser aguardado entre o envio de mensagens ou o tempo total de espera.
  * O tempo limite de espera é o tempo máximo que você vai esperar até que o usuário responda. Se ele não responder naquele tempo máximo o sistema vai executar o subfluxo de tempo limite de espera.
  * Tempo de tolerância é o tempo entre uma mensagem e outra enviada pelo usuário. É ideal para que agrupe todas as mensagens enviadas e as trate como uma só (por exemplo, para enviar para processamento de uma Inteligência Artificial).
  * **Integração:** pode ser utilizado para disparo juntamente com webhook que vai encaminhar um arquiov JSON para uma sistema externo.

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

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

* **Webhooks**: são comandos enviados para ferramentas/sistemas externos (ex.: n8n ou Make). Envia um JSON para uma url externa à plataforma. Nesta URL você vai receber um arquivo com todas as informações sobre o atendimento e sobre o contato com qual você está interagindo naquele momento. Ao devolver uma informação com o código 200 ou 400, o chatbot sistema vai iniciar um fluxo de sucesso ou falha da execução do webhook. Você também pode programar fluxos de retorno ao invés de códigos, como por exemplo retornar um “OK”, “CPF INVÁLIDO”, “NENHUM PAGAMENTO ABERTO”, etc. Com isso você pode criar fluxos alternativos no chatbot que serão executados caso após receber o retorno. Importante citar que uma vez feito o disparo para o seu sistema, o chatbot aguarda por até 20 segundos por uma resposta. Caso ele não obtenha uma resposta do seu sistema no prazo máximo de 20 segundos, vai entra num fluxo alternativo sinalizando que não recebeu um retorno do webhook. Neste ponto você você precisa configurar quais serão as ações a seguir.

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

* As **condicionais** são estruturas utilizadas para **testar informações** e, com base no resultado desse teste, direcionar o fluxo para um caminho específico.

  Cada condicional pode conter **vários casos**, e dentro de cada caso é possível definir **condições** que precisam ser atendidas. Essas condições podem ser:

  * Do tipo **“E”**: todas as condições devem ser verdadeiras ao mesmo tempo.
  * Do tipo **“OU”**: apenas uma das condições precisa ser verdadeira.

  Para alterar o tipo da condicional (**E/OU**), clique no **canto superior direito do agrupamento**.

  No **canto superior esquerdo**, você pode clicar em **“Caso 1”** para **renomear a condicional**, facilitando a leitura e organização.

  É possível adicionar **outros casos** ao grupo de condicionais. O sistema executa os casos **de forma sequencial**:

  * Testa o primeiro caso.
  * Se nenhuma condição for satisfeita, passa para o segundo.
  * Continua testando os casos seguintes, um a um.

  Se **nenhum caso for atendido**, o sistema segue para o **caso padrão**, que representa o **fluxo final** da condicional.

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

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

Atualmente, você pode validar dentro de uma **condicional**:

* **Horário de funcionamento**

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

* **Uma resposta a uma pergunta feita**

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

* **A uma resposta a um modelo de mensagem**

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

* **Teste de valor de um campo personalizado do contato**

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

* **Etiqueta associada a um contato**

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

* **Última mensagem enviada pelo contato**

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

* **Metadados do contato ou do atendimento**

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

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

* **Data atual**

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

* **Dia da semana atual**

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

* **Horário atual**

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

* **Ponto de retorno**: são utilizados para que você desvie o fluxo de execução do seu chatbot para qualquer outro ponto do próprio chatbot. Isso faz com que você não precise ficar copiando e duplicando fluxos,é possível marcar uma um ponto de retorno naquele ponto do seu código do chatbot e então, em qualquer local, você pode desviar o fluxo para aquele ponto de retorno.

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

* **Ações:** escolha ações dentre as seguinte possíveis:
  * Adicionar ou remover uma etiqueta ao contato.
  * Adicionar o seu contato ou remover contato de uma sequência.
  * Aguardar mensagens do contato - essa opção de aguardar mensagens do contato faz com que o chatbot espere até um determinado limite de tempo para que o contato encaminhe uma mensagem, e ficar em pausa durante esse tempo configado esperando uma resposta do contato. Se Neste período o contato encaminhar uma mensagem o chatbot continua para a ação seguinte, caso o tempo limite configurado seja excedido ele entrará no fluxo de exceção por limite de tempo excedido.
  * Espera por alguns segundos: diferente da do aguardar mensagem do contato aqui o chatbot começa a contar o tempo e quando ele acabar vai para a próxima instrução. Ele é ideal para você colocar intervalos de tempo entre disparo de mensagens para seus contatos.
  * Direcionar para outro chatbot.
  * Direcionar para um ponto de retorno.
  * Retornar para o menu anterior
  * Encaminhar o atendimento para uma equipe, assim a qualquer momento você pode pegar um atendimento e encaminhar para uma equipe seja por escolha do seu contato, seja por exemplo, devido a um tempo limite atingido
  * Encerrar um atendimento
  * Modificar meta dados internos do contato ou do atendimento

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

Ao final você clique no botão **salvar alterações**. Após os testes você clica no botão **publicar versão** para que este chatbot fique disponível e comece a responder ao canal de atendimento para o qual ele foi associado.

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

### Considerações finais

* Criar um chatbot na **plataforma** é uma forma inteligente de oferecer **atendimento 24/7**, qualificar seus leads e garantir mais agilidade no suporte. Além disso, você pode monitorar os resultados através de **relatórios de atendimento**, acompanhando quantos contatos foram atendidos pelo bot e onde os clientes mais interagem.
* É possível ainda ver o fluxo de um atendimento no **Log de Atendimento.**
* Lembre-se: um chatbot eficiente depende de **mensagens claras, fluxos bem estruturados** e constante **análise de performance**.

\\


---

# 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.flw.chat/guide/documentacao/apps/chatbot/criando-um-chatbot.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.