Saltar a contenido

Integration Hub

El Integration Hub es un área dedicada dentro de la BotCity Plataforma, accesible desde el Menú Global, que centraliza todas las integraciones disponibles en un solo lugar. Ofrece snippets de código listos para usar, ejemplos de casos de uso e instrucciones de configuración para que puedas conectar tus automatizaciones con herramientas externas de forma rápida.

Consejo

Puedes acceder al módulo Integration Hub a través del menú superior izquierdo del Orquestador, representado por el icono: Orchestrator Menu

Captura de pantalla del Orquestador de BotCity, mostrando la página del Integration Hub. La página muestra tarjetas de integración organizadas por categoría, incluyendo Comunicación, BI & Dashboards, Productividad, Observabilidad y Datos & Almacenamiento.

Migrado desde la pantalla de Integraciones

La pantalla de Integraciones que existía en el Orquestador fue migrada y ampliada en el Integration Hub. Cualquier enlace guardado hacia la pantalla anterior redirigirá automáticamente a la nueva ubicación — no se requiere ninguna acción.

Integraciones disponibles

El Integration Hub agrupa todas las integraciones compatibles en las siguientes categorías:

Categoría Herramienta Tipo Descripción
Comunicación Slack Plugin Envía, lee y gestiona mensajes y archivos de Slack mediante automatizaciones.
Comunicación Email Plugin Envía y recibe correos electrónicos vía IMAP y SMTP en cualquier servidor de correo
Comunicación Gmail Plugin Envía, lee y gestiona mensajes de Gmail en tus automatizaciones
Comunicación Outlook Plugin Envía y gestiona correos corporativos de Outlook
BI & Dashboards Power BI Plugin Visualiza métricas, ROI y datos de rendimiento en Power BI
BI & Dashboards Google Sheets Plugin Lee, gestiona y actualiza hojas de cálculo de Google Sheets
BI & Dashboards Excel Plugin Lee, manipula y actualiza archivos Excel en tus automatizaciones
BI & Dashboards CSV Plugin Lee, manipula y escribe archivos CSV
Productividad Google Drive Plugin Busca, descarga y gestiona archivos en Google Drive
Productividad Google Calendar Plugin Crea, accede y gestiona eventos de Google Calendar
Productividad OneDrive Plugin Gestiona archivos de OneDrive en tus automatizaciones
Productividad SharePoint Plugin Accede y gestiona archivos y documentos de SharePoint
Observabilidad Grafana API Visualiza métricas de la API del Orquestador en dashboards de Grafana
Observabilidad Datadog API Monitorea automatizaciones con métricas y alertas en tiempo real en Datadog
Observabilidad Dynatrace API Monitorea automatizaciones con métricas y eventos vía API de Dynatrace
Datos & Almacenamiento Data Lake API Exporta logs y datos de ejecución vía API del Orquestador

Página de detalle de la integración

Haz clic en cualquier tarjeta para abrir la página de detalle de esa integración. Cada página de detalle tiene dos pestañas:

Pestaña Overview

La pestaña Overview proporciona contexto antes de comenzar:

  • Una descripción de lo que hace la integración.
  • Use Cases: ejemplos prácticos de cómo se puede aplicar la integración.
  • Prerequisites: lo que debe estar configurado antes de comenzar.
  • Un enlace directo a la documentación de BotCity para la integración.

Captura de pantalla del Orquestador de BotCity, mostrando la página de detalle de una integración en la pestaña Overview. La página muestra una descripción de la integración, ejemplos de casos de uso y los requisitos previos necesarios para comenzar.

Pestaña Settings

El contenido de la pestaña Settings varía según el tipo de integración:

Tipo de integración Lo que encontrarás
Plugin Configuración paso a paso con snippets de código copiables por etapa y ejemplos de casos de uso con enlaces a la documentación completa
API Enlace al sitio web y la documentación de la propia herramienta (Grafana, Datadog, Dynatrace), donde se realiza el proceso de configuración

Captura de pantalla del Orquestador de BotCity, mostrando la página de detalle de una integración en la pestaña Settings. La página muestra una guía de configuración paso a paso con snippets de código copiables.

Tip

En las integraciones de tipo Plugin, cada etapa de configuración incluye un botón de copia para que puedas pegar el snippet directamente en el código de tu automatización.

Tokens de Integración

Configura aquí los tokens de autenticación necesarios para conectar el Orquestador a servicios de terceros como Slack y Microsoft Teams.

Captura de pantalla del Orquestador de BotCity, mostrando la página de Tokens de Integración. La página muestra los campos para rellenar con los tokens de integración para el Slack Bot token y Microsoft Teams, junto con una breve descripción.

Consejo

Puedes acceder al menú de Tokens de integración a través del botón que se muestra en el GIF. Botón de tokens de integración en la esquina superior derecha de la página.

Token Slack Bot

El token Slack Bot integra el Orquestador de BotCity con Slack para las notificaciones generales. Una vez que el token es añadido y guardado, los usuarios pueden optar por recibir sus notificaciones vía Slack. Más información sobre cómo obtener un token de Slack aquí.

Integrando el Orquestador de BotCity con Slack

Obtén tu Token OAuth e ID de Canal de Slack: Sigue el paso a paso de la documentación para obtener el token OAuth y el ID de canal de Slack.

Añade el Token OAuth: Accede a la página de Integraciones en tu workspace del Orquestador de BotCity. Localiza el campo "Slack Bot Token", pega el token OAuth obtenido anteriormente y haz clic en Guardar para aplicar los cambios. Menú Integraciones

Vincula tu Perfil a un Canal de Slack: En el Orquestador de BotCity, haz clic en el avatar de tu perfil en la esquina superior derecha y selecciona "Perfil".
Encuentra el campo "Slack ID" e ingresa el ID del canal de Slack. Haz clic en Guardar para completar la integración.
Perfil ID de canal Slack

Activa las notificaciones en tu perfil: Accede al Perfil en el Orquestador de BotCity y asegúrate de que las Notificaciones estén activadas para tu cuenta.
Activar notificaciones

Después de completar estos pasos, el Orquestador de BotCity podrá enviar notificaciones al canal de Slack especificado.

Microsoft Teams

La integración del Orquestador de BotCity con Microsoft Teams permite que los usuarios reciban las notificaciones generales vía Teams.

Configuración de un Webhook

Crea un equipo o dirígete a un equipo donde quieras que se envíen las alertas. En la esquina superior derecha, identifica el ícono con tres puntos. Haz clic en él y luego haz clic en Conectores.

MS Teams Connectors

En el campo de búsqueda de la nueva pantalla, escribe Incoming Webhook. El resultado mostrará la opción como se ilustra a continuación. Tras identificar la opción correcta, haz clic en el botón Configurar.

MS Teams Webhook

En la nueva pantalla que se abre, deberás completar la información necesaria y copiar la URL generada. La URL mapea el canal y puedes usarla para enviar información a Teams.

Deberás pegar la URL generada en el campo Microsoft Teams url en Maestro. Después de eso, podrás configurar las alertas normalmente para que también se dirijan al equipo que seleccionaste.

Impacto en las automatizaciones existentes

No se requiere reconfiguración

El Integration Hub es una interfaz de descubrimiento y configuración. Las integraciones ya configuradas en tus automatizaciones continúan funcionando sin ningún cambio.

  • Las automatizaciones, runners y agendamientos existentes no se ven afectados.
  • Los enlaces antiguos a la pantalla de Integraciones redirigen automáticamente al Integration Hub.
  • El Integration Hub está disponible de inmediato en el Menú Global para todos los workspaces.