Criando meu primeiro BOT

Olá Cosmonauta !! Neste artigo, vou te mostrar um exemplo de como criar o seu primeiro bot na plataforma! Te darei também dicas valiosas sobre boas práticas.

Você sabe como criar um bot?

Para ficar mais fácil, podemos separar a criação do Bot em 3 partes, sendo elas:

1. Definir uma exigência do bot

2. Criar um fluxograma

3. Inserir o bot na plataforma

Dica # 1 : Entender qual é o objetivo do bot ( Definir um uso do bot ) e como ativar ( Criar um fluxograma ) são essenciais antes de realmente colocar a mão na massa! ( Inserir o bot na plataforma )

1. Definir uma necessidade do Bot

Dica # 2 : O bot deve ter uma necessidade principal! Ser informativo, transacional, coletar dados entre outros ... Você pode criar novos fluxos dentro do seu bot e criar cada assunto ou função separadamente, desta forma você garante que o escopo do bot seja menor e fique mais simples para a manutenção !

2. Criar um fluxograma

Esse será o escopo do nosso bot:

Dica # 3 : Existem muitas ferramentas para criar fluxos de maneira rápida, entre elas: Driagram.io , Whimscal

3. Inserir bot na plataforma

Dica # 4 : Para iniciar esta etapa, você precisa acessar a nossa plataforma, você pode acessar (caso já tenha um usuário) ou criar um novo cadastro.

Vamos colocar a mão na massa dentro da plataforma!

Siga este passo-a-passo:

1. Após acessar a plataforma, clique no botão de novo bot. (Conforme imagem abaixo)

2. Nomeie seu Bot, por exemplo: Analista Cosmonauta

Dica # 5 : Você também pode definir seu bot, adicionar uma imagem para identificá-lo e também pode clonar outro bot que já tenha feito!

Fluxos:

Após seguir o 2º passo, o Bot irá abrir uma tela que exibe os Fluxos que ele possui. Por padrão, uma ferramenta sempre virá com 3 Fluxos já criados, sendo eles:

- Boas vindas.

- Exceção.

- Excluir.

* A partir daqui o nosso Bot será separado por fluxos

Fluxo: Boas vindas

3. Altere a mensagem principal do Fluxo Boas Vindas para uma mensagem que lhe agrade, exemplo:

Dica #6 : Dentro das etapas de mensagem você pode citar campos criados na plataforma, escrevendo um simples "@" irá puxar todos os campos, como no caso do exemplo a cima está citando o Nome do cliente.

Dica # 7 : Dentro da Mensagem você também pode criar botões de opções para o usuário, escolher entre salvar ou não a resposta obtida, dentre outras opções.

Fluxo : Filtro

4. Crie outro Fluxo com o nome Menu;

5. Insira um filtro com uma função de identificar se o usuário está ou não cadastrado na ferramenta:

Dica # 8 : Os Filtros disponibilizam uma opção de inserir condições que permitem que sejam feitos direcionamentos, se preferir, também é possível criar Filtros com Funções Complexas .

Fluxo: Usuário cadastrado

6. Crie um novo Fluxo com o nome "usuário cadastrado";

7. Crie uma etapa de Mensagem e nela informe ao usuário que ele já possui cadastro:

Dica # 9 : Quando precisar salvar uma resposta de um cliente como por exemplo em uma pergunta, caso você salve a resposta em um campo de contato, o mesmo irá para a base de dados e ficará salvo na plataforma, caso você salve como um contexto irá ficar salvo apenas durante a sessão atual de conversação entre o Bot e o Cliente, você pode utilizar estes campos como valores para realizar filtros, assim você pode diversificar o seu fluxograma para cada tipo de cliente.

Fluxo: Menu de opções

8. Crie um fluxo chamado "Menu de opções"

9. Agora crie uma mensagem com as opções de criar um novo cadastro ou sabre sobre os produtos oferecidos, salve como contexto e coloque o nome do contexto de "opcao_do_menu":

10. Crie uma etapa em JavaScript para validar a resposta do usuário é um número e uma das opções disponibilizadas:

Dica # 10 : Caso queira criar um bot com características parecidas, código segue usado nessa etapa JavaScript :

const resposta_do_usuario = Number(context.opcao_do_menu);
context.resposta_valida = 0;
console.log(resposta_do_usuario);
console.log(Number.isNaN(resposta_do_usuario));
if (!(Number.isNaN(resposta_do_usuario))) {
   context.resposta_valida = (resposta_do_usuario === 2 || resposta_do_usuario === 1) ? 1 : 0;
}

JavaScript

11. Crie um Filtro que irá validar uma etapa JavaScript

12. Em Campo insira o Contexto, em Nome insira resposta_valida, em Condição insira Igual e em Valor insira 1

13. Clique em "Ou" insira os mesmos dados da etapa 12, porém em Valor insira 2:

14. Agora do lado não do Filtro, crie uma Mensagem com o texto resposta invalida:

15. Após a Mensagem para inserir uma Etapa que direcionará novamente para o Menu de Opções:

Dica # 11 : Caso queira criar um bot com características parecidas, código segue usado nessa etapa JavaScript :

16. Crie outro filtro;

17. Em campo insira Contexto, em Nome insira opcao_do_menu, em Condição insira Igual e em valor insira 1:

Fluxo: Produtos oferecidos

18. Crie um Fluxo com o Nome Produtos oferecidos;

19. Insira a Mensagem que informa quais são os produtos oferecidos:

Fluxo: Cadastro

20. Crie um fluxo com o nome "Cadastro"

21. Crie uma mensagem solicitando o nome do usuário;

22. Uma solicitando o e-mail;

23. Uma perguntando se os dados informados estão corretos;

24. E uma de confirmação. Essa deve ser salva como Contexto, e o Nome do contexto salvo como opcao_do_menu2:

25. Crie uma etapa em JavaScript para validar a resposta do usuário é um número e uma das opções disponibilizadas:

Dica # 10 : Aqui vai outro exemplo de código JavaScript que pode ser usado para filtrar como informações oferecidas pelo usuário:

let testando_validade_resposta= Number(context.opcao_do_menu2)
context.validade_resposta = 0;
if (!(Number.isNaN(context.testando_validade_resposta))) {
   context.validade_resposta= (testando_validade_resposta === 1|| testando_validade_resposta ===2)? 1 : 0;
   
} 

JavaScript

26. Crie um Filtro que irá validar uma etapa JavaScript;

27. Em campo insira o contexto, em nome insira a validação_resposta, em condição insira igual e em valor insira 1;

28. Agora repita os passos 13, 14 e 15:

29. Crie outro Filtro;

30. Em Campo insira Contexto, em Nome insira opcao_do_menu2, em Condição insira Igual e em valor insira 1:

31. Crie uma mensagem de finalização:

32. Agora conecte todos os fluxos usando como Etapas:

Vamos testar o bot?

Informações adicionais:

Nesse exemplo, use as etapas no JavaScript para demonstrar as características da ferramenta, mas o uso do código na criação do bot não é obrigatório.