Como ligar o Botpress V12 ao Telegram

Este guia ensina como integrar um agente Botpress V12 no AutoTalk.

1 Introdução #

Note que o Botpress V12 é um programa standalone e deve rodar em algum servidor. No caso desse guia, estamos executando ele localmente e expondo para internet via ngrok. Atente-se nos dados do seu ambiente.

2 Clique em “Empresa” #

Acesse as configurações da empresa.

3 Clique em “Agentes” #

Vá para a seção de agentes.

4 Adicione um novo agente #

Adicione um novo agente clicando no botão com símbolo de “+” na parte superior da tela.

5 Defina o nome do agente #

Aqui você deve definir o nome do agente.

6 Preencher nome do agente #

Preencha “meu_agente”

7 Defina o tipo do agente #

Nesse campo você define o tipo do agente

8 Clique em “Botpress V12” #

No nosso caso escolheremos Botpress V12, cuidado para não confundir com Botpress Cloud que é outra plataforma.

9 Crie o novo agente #

Clique no botão verde na parte superior da tela para criar o novo agente.

10 Página de configuração do agente #

Você será redirecionado para a página de configuração do agente Botpress V12.

11 Defina a URL do seu agente Botpress V12 #

Nesse campo precisamos definir a URL da API do Botpress V12. E essa URL vai variar de acordo com o servidor em que o seu Botpress V12 está executando.

12 Nosso dashboard do Botpress V12 #

Dê uma olhada na nossa página de dashboard do Botpress V12.

13 A URL base #

O importante é checar a URL base. No caso do nosso exemplo é essa em destaque.

14 https://lively-advanced-reptile.ngrok-free.app/api/v1/bots/ID_DO_BOT/converse #

Do endereço da aba do navegador do Botpress V12 podemos gerar parte da URL final. Ela ficará dessa forma. Agora só precisamos definir o valor da parte em maiúsculo: “ID DO BOT”

15 Escolha o agente que quer integrar #

Escolha qual agente você quer integrar. No nosso caso será o image-bot

16 Clique em “Config” #

Vamos pegar o id desse agente. Para isso, clique em “Config”

17 ID do agente #

Você será redirecionado para uma página que contém o id do agente.

18 https://lively-advanced-reptile.ngrok-free.app/api/v1/bots/image-bot/converse #

Com esse dado em mãos você já pode finalizar a construção da URL de integração.

19 Defina aqui a URL gerada nos passos anteriores #

Defina aqui a URL adquirida no passo anterior.

20 Preencher “https://lively-advanced-reptile.ngrok-free.app/api/v1/bots/image-bot/converse” #

Digite o texto desejado.

21 Verifique a URL #

Verifique se a URL está correta.

22 Salve seu novo agente #

Salve seu agente clicando no botão verde na parte superior da tela. O AutoTalk realiza um teste na URL configurada quando você apertar esse botão, então, se tiver algum erro na URL ele vai acusar agora.

23 Volte para página anterior #

Certo, com tudo salvo, vamos definir esse agente como o agente padrão. Clique no botão para voltar para página anterior

24 Localize seu novo agente #

Encontre seu novo agente na lista.

25 Expanda o menu de opções #

Clique no ícone com 3 pontos para abrir o menu de opções do agente

26 Clique em “Definir padrão” #

Selecione a opção “Definir padrão”.

27 Vamos testar o nosso novo agente #

Para testar seu novo agente clique no botão verde com ícone de “play”.

28 Uma nova área com um chat será aberta #

Uma nova área na parte direita da janela vai ser aberta. Vamos usar ela para testar nosso novo agente.

29 Digite uma mensagem para seu agente #

Mande um “olá” para seu novo agente.

30 Preencher “Olá” #

Digite “Olá” no campo fornecido

31 Verfique se o agente responde #

Verifique se o agente responde corretamente. No nosso exemplo deu tudo certo!

Este guia detalhou os passos necessários para integrar um agente Botpress V12 no AutoTalk. Caso ainda existam dúvidas ou você enfrente problemas, entre em contato com o suporte.

Neste guia, aprenderemos como criar um bot no Telegram utilizando o Autotalk

1 Clique em “Empresa” #

Clique no botão Empresa para expandir o menu.

2 Clique em “Canais” #

Clique no botão “Canais” para abrir a sua lista de canais de comunicação

3 Adicionando um novo Canal #

Clique no botão com símbolo de “+” na parte superior da tela para iniciar o processo de criação de um novo canal.

4 Selecione o tipo do novo canal #

Nesse campo você pode selecionar o tipo do novo canal de comunicação.

5 Clique em “Telegram” #

No caso desse guia selecionaremos Telegram.

6 Clique em “Próximo passo” #

Prossiga clicando em “Próximo passo”.

7 Volte para a aba do AutoTalk #

Você será redirecionado para a página de configuração do novo canal do Telegram. Mas nós ainda precisamos criar o “bot” dentro do sistema do Telegram.

8 Vamos criar nosso bot na tela do Telegram #

Para isso, acesse a página do Telegram em outra aba.

9 Pesquise por “BotFather” #

No campo de pesquisa, digite “BotFather” para encontrar o criador de bot oficial do Telegram

10 Selecione o “BotFather” #

Clique no “BotFather”.

11 Inicie o processo de criação de bot #

Clique no botão “START” para iniciar o processo de criação de bot no Telegram.

12 Clique em “/newbot” #

O “BotFather” irá enviar uma longa mensagem, mas só nos interessa o comando “newbot”. Clique em “newbot” no início da mensagem.

13 Digite o nome do bot #

Agora, digite no campo o nome que você deseja para o bot.

14 Escolhido o nome do novo bot #

Aqui escolhemos o nome “meu_novo_autotalk_bot”

15 Defina o arroba do bot #

Preencha o arroba do bot que você deseja.

16 Definido o arroba do bot #

Aqui definimos o arroba do bot igual ao nome do bot.

17 Bot criado com sucesso #

Se tudo der certo, o BotFather responderá com os dados do novo bot

18 Token do Bot #

O importante para nós é o token do bot, que será usado para integrar ele com o AutoTalk. Clique no texto laranja para copiar o token.

19 Volte para a aba do AutoTalk #

Volte para aba do AutoTalk, na página do novo canal Telegram que estavamos criando.

20 Clique em “Editar” #

Clique no botão editar para mostrar o campo onde preencheremos com o token do bot que copiamos no passo anterior.

21 Cole o token do bot #

Cole o token do bot enviado pelo BotFather

22 Preencher token #

Digite o texto desejado.

23 Clique em “Salvar” #

Salve as alterações feitas.

24 Clique em “Conectar” #

Clique em conectar para conectar o AutoTalk ao seu bot no Telegram

25 Clique em “Chats” #

Agora, vamos enviar uma mensagem de teste ao nosso bot. Acesse a seção de “Chats”.

26 Overview #

27 Volte para aba do Telegram #

Volte para a aba do Telegram.

28 Clique no link do seu novo bot #

O BotFather envia um link para o seu bot, além do token. O link se encontra no início da mensagem que contém o token, clique nesse link.

29 Inicie a conversa com seu bot #

Clique no botão “START” para iniciar uma conversa com seu novo bot.

30 O bot responderá com o agente padrão da sua empresa #

Se sua empresa tiver um agente padrão definido, ele responderá a essa mensagem inicial enviada.

31 Volte para o AutoTalk #

Volte para a página do AutoTalk na aba Chats. Você verá que recebeu uma nova mensagem.

32 Abra a conversa #

Abra essa nova conversa.

33 Confira as mensagens #

Confira o conteúdo da conversa.

34 Envie uma mensagem de teste #

Você tem a opção de enviar uma mensagem manualmente para o cliente.

35 Digite uma mensagem para o cliente #

Digite “Olá, essa é” no campo fornecido

36 Volte para o Telegram #

Volte para a aba do Telegram e confira se a mensagem foi recebida com sucesso.

37 Mensagem recebida! #

Tudo certo, a mensagem foi recebida corretamente. O novo canal de comunicação está funcionando corretamente!

Este guia abordou o processo de criação de um bot no Telegram utilizando o Autotalk. Caso enfrente algum problema ou tenha dúvidas, não hesite em contatar o suporte.