[Extensão] Como conectar o banco de dados MySQL em Contatos Inteligentes Blip

1. Introdução

2. Funcionalidades

3. Instalação e configuração

4. Manual de uso

5. Dependências

6. Suporte

A MySQL for Blip chegou para facilitar a vida do dev. Conecte o Blip diretamente ao seu banco de dados MySQL sem a necessidade de APIs intermediárias. Com a MySQL for Blip, insira suas credenciais de conexão e execute consultas e operações de banco de dados diretamente no Builder ou Studio.

Palavras chave: MySQL, banco de dados, integração, MySQL, conexão, consultas, SQL, API, roteador, extensão blip, eficiência.

Introdução

O MySQL for Blip, desenvolvido pela Sharkdev, é uma extensão que permite conectar o Blip diretamente ao seu banco de dados MySQL utilizando dados de conexão, eliminando a necessidade de construir e manter uma API intermediária.

Como exemplo prático de uso, você pode utilizar a extensão diretamente no Builder ou Studio para consultar o status de um pedido no banco de dados da sua empresa e exibir essa informação para o cliente em tempo real durante o fluxo conversacional. 
 

Funcionalidades

A extensão MySQL for Blip foi desenvolvida tendo como objetivo permitir que desenvolvedores acessem bancos de dados diretamente pelo Builder ou Studio, sem a necessidade de uma API intermediária.
As seguintes funcionalidades são oferecidas:

• Conexão com banco de dados;

• Execução de instruções SQL no banco de dados por requisições HTTP;

• Visualização de instruções SQL executadas no banco de dados nos últimos 30 dias;

Instalação e configuração

Para utilizar a extensão MySQL for Blip, é necessário acessar o contrato ao qual deseja instalá-la, e logo após acessar o bot Router. Feito isso, navegue até a parte de extensões onde será aberta a Blip Store, e busque por “MySQL for Blip”. Assim que encontrar, será necessário ativá-la e fazer a sua instalação.

Após ativada, instalada e com termos aceitos, é necessária uma pequena configuração para que você possa iniciar a utilização, siga o passo a passo abaixo.

1) Conectando ao banco de dados

Na página principal da extensão, informe name, host, port, user e password no formulário de conexão e clique em "Conectar".

Se a conexão for feita com sucesso, rapidamente você verá a mensagem "Banco de dados conectado". Caso não tenha sucesso, sugerimos que revise os dados de conexão preenchidos no formulário.

2) Definir token nas variáveis de configuração dos bots

Para que o seu bot consiga utilizar a extensão, é necessário que o token de autorização seja informado no momento da requisição.

Sendo assim, sugerimos que. 

* Esta etapa não é obrigatória, mas é uma sugestão visando a manutenção do Contato Inteligente.

3) Agora é só usar!

Nesse passo, a extensão está configurada e você já pode utilizá-la. Para isso, conheça o conceito de comandos no “Manual de uso”.
 

Manual de uso

• Instruções SQL

Siga as instruções abaixo para se comunicar com a extensão via Builder:

Dados básicos

URL base: https://mysqlforblip.blip.sharkdev.com.br/query

Token de autorização: {{config.token}} ou Cabeçalho de autenticação (Authorization)

Como executar comando

Para executar um comando, configure uma Requisição HTTP, utilizando método POST, para a URL informada em URL base, informando o Token de autorização na chave "Authorization" do Cabeçalho. Para facilitar, veja a imagem abaixo:

Agora, você precisa definir o Body da requisição. Para isso, o JSON enviado deve seguir os atributos abaixo:

Dependências

Para que essa extensão funcione corretamente, é necessário que você a contrate pela Blip Store acessando o Blip através de uma conta pagadora. Além disso, é necessário a utilização de um banco de dados próprio.
 

Suporte

Em caso de dúvidas ou se encontrar algum problema com a extensão, entre em contato conosco pelo e-mail blippartner@sharkdev.com.br ou no número +55 (35) 98802-9321.

Precisa de mais ajuda? Explore nossos conteúdos na Blip Academy ou Blip Community, assista a tutoriais no nosso canal do YouTube ou tire suas dúvidas em nosso canal de atendimento 😃