Saltar al contenido principal

[Extensión] Cómo conectar una base de datos MongoDB en Contactos Inteligentes Blip

  • Actualización

Índice:

  1. Introducción
  2. Funcionalidades
  3. Instalación y configuración
  4. Manual de uso
  5. Dependencias
  6. Soporte 

 

Descripción breve: MongoDB for Blip llegó para facilitarles la vida a los desarrolladores. Conecta Blip directamente a tu base de datos PostgreSQL sin necesidad de APIs intermediarias. Con MongoDB for Blip, ingresa tus credenciales de conexión y ejecuta consultas y operaciones de base de datos directamente en Builder o Studio. 

Palabras clave: MongoDB, base de datos, integración no SQL, PostgreSQL, conexión, consultas, API, router, extensión de Blip, eficiencia, NoSQL.

 

Introducción

MongoDB for Blip, desarrollado por Sharkdev, es una extensión que permite conectar Blip directamente a tu base de datos MongoDB mediante datos de conexión, eliminando la necesidad de crear y mantener una API intermediaria.

Como ejemplo práctico de uso, puedes utilizar la extensión directamente en Builder o Studio para consultar el estado de un pedido en la base de datos de tu empresa y mostrar esta información al cliente en tiempo real durante el flujo conversacional. 

 

Funcionalidades

La extensión MongoDB for Blip fue desarrollada con el objetivo de permitir que los desarrolladores accedan a bases de datos directamente desde Builder, sin necesidad de una API intermediaria.
Se ofrecen las siguientes funcionalidades:

  • Conexión con una base de datos propia;
  • Ejecución de comandos en la base de datos mediante solicitudes HTTP;
  • Visualización de los comandos ejecutados en la base de datos durante los últimos 30 días;

 

Instalación y configuración

Para utilizar la extensión MongoDB for Blip, es necesario acceder al contrato en el que deseas instalarla y, después, acceder al bot Router. Una vez hecho esto, navega hasta la sección de extensiones, donde se abrirá Blip Store, y busca “MongoDB for Blip”. Cuando la encuentres, será necesario activarla e instalarla.

Después de activarla, instalarla y aceptar los términos, es necesario realizar una pequeña configuración para poder comenzar a utilizarla. Sigue los pasos a continuación.

Paso 1 - Conectarse a la base de datos

En la página principal de la extensión, ingresa name, host, user y password en el formulario de conexión y haz clic en "Conectar".

Si la conexión se realiza correctamente, verás rápidamente el mensaje "Base de datos conectada". Si no se realiza correctamente, te sugerimos revisar los datos de conexión ingresados en el formulario.

 

Paso 2: definir el token en las variables de configuración de los bots

Para que tu bot pueda utilizar la extensión, es necesario informar el token de autorización al momento de realizar la solicitud.

* Este paso no es obligatorio, pero es una sugerencia para facilitar el mantenimiento del Contacto Inteligente.

Paso 3 - ¡Ahora solo tienes que usarla!

En este paso, la extensión ya está configurada y puedes comenzar a utilizarla. Para ello, conoce el concepto de comandos en el “Manual de uso”.

 

Manual de uso

Comandos

Al igual que Blip, la forma de comunicarse con la extensión mediante Builder es a través de comandos. Para ello, sigue las instrucciones a continuación:

Datos básicos

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

Token de autorización: {{config.token}} o Encabezado de autenticación (Authorization)

Cómo ejecutar un comando

Para ejecutar un comando, configura una Solicitud HTTP utilizando el método POST, dirigida a la URL indicada en URL base, e informa el Token de autorización en la clave "Authorization" del encabezado. Para facilitarlo, consulta la imagen a continuación:

Ahora debes definir el Body de la solicitud. Para ello, el JSON enviado debe seguir los atributos que se indican a continuación:

Atributo Tipo Obligatorio Descripción
collection string Sí Nombre de la colección en la que se ejecutará el comando.

Ejemplo: notes
command object Sí Lista de métodos que se ejecutarán, basada en métodos de Collection y Cursor del propio MongoDB.

Ejemplo: {
  find: {
    group: 'example'
  },
  sort: 'name'
}
apply boolean No

Hace que los métodos de tipo array se coloquen como parámetros del método que se procesará.


Predeterminado: false

A continuación, presentamos algunos ejemplos del Body de una solicitud.

Cómo insertar un documento
Cómo buscar un documento específico
Cómo listar documentos
Cómo actualizar un documento
Cómo eliminar un documento
Cómo ordenar una lista de documentos

Cómo ejecutar un aggregate

 

Dependencias

Para que esta extensión funcione correctamente, es necesario contratarla a través de Blip Store accediendo a Blip mediante una cuenta de pago. Además, es necesario utilizar una base de datos propia.

 

Soporte

En caso de dudas o si encuentras algún problema con la extensión, contáctanos por correo electrónico en suporte@sharkdev.com.br o al número +55 (35) 99148-3887.

 

 

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención.

Artículos relacionados