Extensão MongoDB for Blip 22 de abril de 2024 13:12 Atualizado Índice: Introdução Como funciona? Instalação e configuração Manual de uso Dependências Termos de uso Suporte Introdução A extensão MongoDB 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 MongoDB for Blip chegou para facilitar a vida do dev que precisa se conectar a um banco Mongo. Nada de API intermediária! Agora você pode contar com MongoDB for Blip. Com esta extensão, você conecta o Blip ao seu banco de dados MongoDB 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 MongoDB for Blip. Como funciona? 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 utilizar ObjectId 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. 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. 😃 Artigos relacionados Motor de Inteligência Artificial da STILINGUE BLU (Blip Language Understanding) Como publicar seu bot no Microsoft Teams Como publicar seu bot no Google Assistant Como utilizar o Agente de IA?