Como criar um bot com estrutura HTTP com api em C# [Avançado]

Olá Blippers, vocês estão bem? :happyblip:

Espero que sim, hoje vou apresentar como criar criar um bot http utilizando uma api em C# sei que não é muito comum, mas acho muito bom ter esse tipo de conteúdo no fórum.

Antes de começar o guia vamos a explicação o que é um bot Http ?
Neste modelo de contrução HTTP o Blip realiza requisições em um endpoint definido pelo desenvolvedor do chatbot sempre que novas mensagens ou notificações estiverem disponíveis. Da mesma forma, sempre que o bot quiser enviar uma mensagem para o cliente será necessário realizar uma requisição HTTP na API do Blip. A vantagem em utilizar o modelo API HTTP é ter a possibilidade de construir seu bot em linguagens de programação diferente de C#, Javascript , Java entre outras dependendo da equipe de desenvolvimento e do suporte a requisições HTTP.
Isso permite a criação de um bot sem limites que existem no builder como time out de ações, time out de requisições, biblioteca de scripts e utilização do bot para realizar qualquer tipo de tarefa onde o limite seria da própria api. Nesse modelo a api passa a ser o bot e ele fica hospedado do lado do cliente.

Agora vamos a criação do bot.

1° Passo : Crie um bot e habilite ele para a estrutura http

1.1 A criação do bot é feito na tela principal do portal
image
Crie um bot do zero mesmo.


De um nome para ele.

1.2 Agora vamos na aba de configurações :
image
1.3 Depois na parte de informações de conexão.

Sei que ainda não criamos a Api para isso vou deixar aqui o link da Api em C# que criei para esse guia e ela é bem simples está disponível no github : Link Aqui

2° Passo : Clone o repositório abra a solution com o Visual Studio.
image
2.1 Altere o arquivo appsettings com a chave do bot e url base do seu bot :


Essas informações se encontram no portal abaixo a conexão usando HTTP.
image
e na url não precisa do /message a api insere automaticamente, precisamos só do inicio.
2.2 Após a alteração dos dados salves e rode a api vai aparecer mais o menos assim :
image
e o swagger
image

Agora vamos utilizar o ngrok para fazer um conexão como se o computador fosse um servidor
: Link Aqui
Coloque o ngrok em uma pasta de sua preferencia.

Recomendo que crie uma conta no ngrok para ter um certificado valido e é gratis.
Registro Ngrok
image

3° Passo : Abra o cmd como administrador navege até a pasta que ta o ngrok
3.1 Rode o comando de adicionar o certificado
3.2 Rode o comando conforme imagem :
image

Ai ele vai gera um link temporario :

Vamos copiar o link e testar a interface e comunicação da api lembrando que o link para o swagger é
https://{{urlngrok}}/swagger/index.html
image

4° Passo : Vamos pegar a url do comando e colocaremos no Blip pela mesma etapa do passo 1.3
ficara assim a url do comando que remos colocar no portal

https://{{urlngrok}}/api/Bot

Clique em Salvar e faça o teste chamando o bot.
Pode chamar pela aba de teste de fluxo pulicado
image

image

Sei que só configuramos uma mensagem, mas é para apenas dar ideia de como funciona essa estrutura de bot.

Espero ter ajudado e duvida coloque abaixo que respondo sempre que possível.
:rocket:

2 curtidas