PostgreSQL for Blip

Índice:

1. Introdução
2. Como funciona?
3. Instalação e configuração
4. Manual de uso
5. Dependências
6. Termos de uso
7. Suporte

Introdução

A extensão PostgreSQL for Blip foi desenvolvida pela empresa Sharkdev. Atualmente, ela se encontra na versão 1.0.0 e está disponível para assinaturas e utilização.

 

A PostgreSQL for Blip chegou para facilitar a vida do dev que precisa se conectar a um banco PostgreSQL. Nada de API intermediária! Agora você pode contar com PostgreSQL for Blip 😍. Com esta extensão, você conecta o Blip ao seu banco de dados PostgreSQL informando os dados de conexão e já pode sair usando no Builder. É fácil e rápido! Vamos lá!

 

Este manual tem como objetivo auxiliar os usuários da plataforma Blip na instalação, configuração e utilização da extensão PostgreSQL for Blip.

 

Como funciona?

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

• Conexão com banco de dados próprio;
• 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 PostgreSQL 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 “PostgreSQL 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ário uma pequena configuração para que você possa iniciar a utilização, siga o passo a passo abaixo.

 

Passo 1) Conectando ao banco de dados

Na página principal da extensão, informe name, host, port, user, password e SSL 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.

 

 

Passo 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.

 

Passo 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://postgresqlforblip.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.

 

Termos de uso

• O banco de dados acessado por meio desta aplicação pertence exclusivamente ao cliente;
• O histórico de requisições ao banco de dados ficará acessível por 30 dias;
• A SharkDev não reivindica qualquer direito de propriedade sobre os dados armazenados no banco de dados do cliente;
• Os dados de acesso ao banco de dados (como senhas, tokens ou chaves de autenticação) são armazenados de maneira segura em nosso banco de dados interno;
• O cliente é responsável por configurar e gerenciar os níveis de acesso dos usuários do banco de dados;
• O cliente é o único responsável pelos dados trafegados, armazenados ou retornados do banco de dados;
• A SharkDev não assume qualquer responsabilidade por perda, corrupção ou uso indevido desses dados;
• Reservamo-nos o direito de atualizar ou modificar estes Termos a qualquer momento;
• A SharkDev não se responsabiliza pelo compartilhamento de chaves de autenticação ao Blip quando divulgados pelo cliente;
• Todas as informações veiculadas serão tratadas com absoluto sigilo e confidencialidade, única e exclusivamente dentro do seu ambiente Blip e estão de acordo com a Lei Geral de Proteção de Dados Pessoais (Lei nº 13.709/2018 - LGPD).
  
  

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.

 

 

Para mais informações, acesse a discussão sobre o assunto em nossa comunidade ou os vídeos no nosso canal.😃