Integration Hub

Ir para o Integration Hub

O Integration Hub é uma área dedicada dentro da BotCity Plataforma, acessível pelo Menu Global, que centraliza todas as integrações disponíveis em um único lugar. Ele oferece snippets de código prontos para uso, exemplos de casos de uso e instruções de configuração para que você conecte suas automações a ferramentas externas rapidamente.

Dica

Você pode acessar o módulo Integration Hub através do menu superior esquerdo do Orquestrador, representado pelo ícone:

Migrado da tela de Integrações

A tela de Integrações que existia no Orquestrador foi migrada e expandida para o Integration Hub. Qualquer link salvo para a tela antiga redirecionará automaticamente para o novo local — nenhuma ação é necessária.

Integrações disponíveis

O Integration Hub agrupa todas as integrações suportadas nas seguintes categorias:

Categoria	Ferramenta	Tipo	Descrição
Comunicação	Slack	Plugin	Envia, lê e gerencia mensagens e arquivos do Slack nas automações
Comunicação	Email	Plugin	Envia e recebe e-mails via IMAP e SMTP em qualquer servidor de e-mail
Comunicação	Gmail	Plugin	Envia, lê e gerencia mensagens do Gmail nas automações
Comunicação	Outlook	Plugin	Envia e gerencia e-mails corporativos do Outlook
BI & Dashboards	Power BI	Plugin	Visualiza métricas, ROI e dados de desempenho no Power BI
BI & Dashboards	Google Sheets	Plugin	Lê, gerencia e atualiza planilhas do Google Sheets
BI & Dashboards	Excel	Plugin	Lê, manipula e atualiza arquivos Excel nas automações
BI & Dashboards	CSV	Plugin	Lê, manipula e escreve arquivos CSV
Produtividade	Google Drive	Plugin	Busca, baixa e gerencia arquivos no Google Drive
Produtividade	Google Calendar	Plugin	Cria, acessa e gerencia eventos do Google Calendar
Produtividade	OneDrive	Plugin	Gerencia arquivos do OneDrive nas automações
Produtividade	SharePoint	Plugin	Acessa e gerencia arquivos e documentos do SharePoint
Observabilidade	Grafana	API	Visualiza métricas da API do Orquestrador em dashboards do Grafana
Observabilidade	Datadog	API	Monitora automações com métricas e alertas em tempo real no Datadog
Observabilidade	Dynatrace	API	Monitora automações com métricas e eventos via API do Dynatrace
Dados & Armazenamento	Data Lake	API	Exporta logs e dados de execução via API do Orquestrador

Página de detalhe da integração

Clique em qualquer card para abrir a página de detalhe daquela integração. Cada página de detalhe possui duas abas:

Aba Overview

A aba Overview oferece contexto antes de você começar:

• Uma descrição do que a integração faz.
• Use Cases: exemplos práticos de como a integração pode ser aplicada.
• Prerequisites: o que precisa estar configurado antes de começar.
• Um link direto para a documentação BotCity da integração.

Aba Settings

O conteúdo da aba Settings varia de acordo com o tipo da integração:

Tipo de integração	O que você encontra
Plugin	Passo a passo de configuração com snippets de código copiáveis por etapa e exemplos de casos de uso com links para a documentação completa
API	Link para o site e a documentação da própria ferramenta (Grafana, Datadog, Dynatrace), onde o processo de configuração é realizado

Tip

Nas integrações do tipo Plugin, cada etapa de configuração inclui um botão de cópia para que você cole o snippet diretamente no código da sua automação.

Tokens de Integração

Configure aqui os tokens de autenticação necessários para conectar o Orquestrador a serviços de terceiros como Slack e Microsoft Teams.

Dica

Você pode acessar o menu de Tokens de Integração através do botão mostrado pelo GIF.:

Token Slack Bot

O token Slack Bot integra o BotCity Orquestrador com o Slack para notificações gerais. Depois que o token é adicionado e salvo, os usuários podem optar por receber suas notificações via Slack. Mais informações sobre como obter um token do Slack aqui.

Integrando o BotCity Orquestrador com o Slack

Obtenha seu Token OAuth e ID do Canal do Slack: Siga o passo a passo da documentação para obter o token OAuth e o ID do canal do Slack.

Adicione o Token OAuth: Acesse a página de Integrações no seu workspace do BotCity Orquestrador. Localize o campo "Slack Bot Token", cole o token OAuth obtido anteriormente e clique em Salvar para aplicar as mudanças.

Vincule seu Perfil a um Canal do Slack: No BotCity Orquestrador, clique no avatar do seu perfil no canto superior direito e selecione "Perfil".
Encontre o campo "Slack ID" e insira o ID do canal do Slack. Clique em Salvar para concluir a integração.

Ative as notificações no seu perfil: Acesse o Perfil no BotCity Orquestrador e certifique-se de que as Notificações estão ativadas para sua conta.

Depois de concluir essas etapas, o BotCity Orquestrador poderá enviar notificações para o canal do Slack especificado.

Microsoft Teams

A integração do BotCity Orquestrador com o Microsoft Teams permite que os usuários recebam as notificações gerais via Teams.

Configurando um Webhook

Crie um time ou vá até um time no qual você queira que os alertas sejam enviados. No canto direito superior, identifique o ícone com três pontos. Clique nele e, em seguida, clique em Conectores.

No campo de pesquisa da nova tela, digite Incoming Webhook. O resultado trará a opção conforme print abaixo. Após identificar a opção correta, clique no botão Configurar.

Com a nova tela que se abriu, você deverá preencher as informações necessárias e copiar a URL gerada. A URL mapeia o canal e você pode usá-la para enviar informações ao Teams.

Você deverá colar a URL gerada dentro do campo Microsoft Teams url no Maestro. Após isso, será possível configurar os alertas normalmente para que eles sejam direcionados também para o time que você selecionou.

Impacto nas automações existentes

Nenhuma reconfiguração necessária

O Integration Hub é uma interface de descoberta e configuração. Integrações já configuradas nas suas automações continuam funcionando sem nenhuma alteração.

• Automações, runners e agendamentos existentes não são afetados.
• Links antigos para a tela de Integrações redirecionam automaticamente para o Integration Hub.
• O Integration Hub está disponível imediatamente no Menu Global para todos os workspaces.