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


Reputação 7
Crachá +3

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.

🚀


Nenhum comentário

Nenhum comentário

Comente