Pular para o conteúdo principal

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

  • Atualizado

Índice:

  1. Introdução
  2. Funcionalidades
  3. Instalação e configuração
  4. Manual de uso
  5. Dependências
  6. Suporte 

 

Descrição breve: A MongoDB for Blip chegou para facilitar a vida do dev. Conecte o Blip diretamente ao seu banco de dados PostgreSQL sem a necessidade de APIs intermediárias. Com a  MongoDB 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: MongoDB, banco de dados, no Sql Integração, PostgreSQL, Conexão, Consultas, API, roteador, extensão blip, eficiência, nosql.

 

Introdução

O MongoDB for Blip, desenvolvido pela Sharkdev, é uma extensão que permite conectar o Blip diretamente ao seu banco de dados MongoDB 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 MongoDB 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 comandos no banco de dados por requisições HTTP;
  • Visualização de comandos executados no banco de dados nos últimos 30 dias;

 

Instalação e configuração

Para utilizar a extensão MongoDB 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 “MongoDB 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, 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.

 

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.

* 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

Comandos

Assim como o Blip, a forma de se comunicar com a extensão via Builder é por Comandos. Para isso, siga as instruções abaixo:

Dados básicos

URL base: https://mongoforblip.blip.sharkdev.com.br/commands

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:

Atributo Tipo Obrigatório Descrição
collection string Sim Nome da coleção na qual o comando será executado.

Exemplo: notes
command object Sim Lista de métodos a serem executados, baseado em métodos de Collection e Cursor do próprio MongoDB.

Exemplo: {
  find: {
    group: 'example'
  },
  sort: 'name'
}
apply boolean Não

Faz com que métodos do tipo array sejam colocados como parâmetros do método a ser processado.


Default: false

Abaixo, listamos alguns exemplos de Body de uma requisição.

Como inserir documento
Como buscar um documento específico
Como listar documentos
Como atualizar documento
Como excluir documento
Como ordenar listagem de documentos

Como executar um aggregate

 

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 suporte@sharkdev.com.br ou no número +55 (35) 99148-3887.

 

 

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.

Artigos relacionados