Usando a integração de chatbot do GitHub Enterprise da Zoom

O Zoom integrou seu bate-papo Zoom no GitHub Enterprise, permitindo que você receba notificações de bate-papo do Zoom chat sobre alterações em seu repositório GitHub Enterprise, bem como mensagens de um chatbot relacionadas a essas alterações. Os servidores privados do GitHub Enterprise devem ser integrados a essa integração.

Pré-requisitos para o GitHub Enterprise

• É necessária uma conta no GitHub Enterprise

• O chatbot do GitHub Enterprise foi pré-aprovado para inclusão em zoom Mercado de aplicativos
  Observação: Você precisará entrar em contato com o administrador do Zoom se o aplicativo não tiver sido pré-aprovado.

Como instalar e configurar o GitHub Enterprise

Instale a partir do Zoom App Marketplace

1. Como administrador da conta, assine em zoom Mercado de aplicativos.

2. O GitHub Enterprise pode ser encontrado inserindo a palavra-chave GitHub Enterprise na caixa de pesquisa no no canto superior direito de sua tela.

3. Escolha o aplicativo GitHub Enterprise nos resultados da pesquisa e clique nele para abri-lo.

4. Observação: Você precisará entrar em contato com o administrador do Zoom se o aplicativo não for pré-aprovado para sua conta. Por favor, deixe-os saber que você gostaria que este aplicativo fosse aprovado.

5. Por favor Clique no Adicionar botão.

6. Se você aceitar as permissões do aplicativo, clique em Permitir quando terminar.
   Observação: você poderá usar automaticamente o chatbot do GitHub Enterprise no cliente Zoom se o administrador o tiver instalado para você.

Configurar a assinatura do GitHub Enterprise

A página Adicionar assinatura do GitHub Enterprise aparecerá depois que o aplicativo for instalado no Marketplace. Por favor, prossiga para a página após a instalação.

1. Sua conta do GitHub Enterprise precisará ser autenticada.
   Como parte do processo de autorização, você será solicitado a fornecer um Client ID e Client Secret de sua conta para se conectar ao seu servidor privado.

2. Se você possui uma conta Enterprise no GitHub, pode acessá-la aqui.

3. Você pode acessar Configurações do desenvolvedor – Aplicativos OAuth clicando em Configurações e, em seguida, clicando em Configurações do desenvolvedor.
   Para permitir que o Zoom acesse seus relatórios, você deve adicionar um aplicativo OAuth à sua conta.

4. O nome do aplicativo deve ser Zoom e o seguinte deve ser usado para a descrição do aplicativo:

5. O ID do cliente, bem como o segredo do cliente, devem ser copiados.

6. O Zoom o levará de volta à página onde você pode configurar o GitHub Enterprise para sua organização.

7. Em seguida, insira o domínio de seu servidor, o ID do cliente e o segredo do cliente que deseja usar.

8. Salve a configuração clicando no botão Salvar.
   A página irá redirecioná-lo para a conta do GitHub Enterprise em seu servidor privado.

9. Selecione Autorizar no menu suspenso.
   Agora você poderá acessar o Zoom por meio de sua conta do GitHub Enterprise.

Como usar o chatbot do GitHub Enterprise

Adicionar uma assinatura

Observação: Para adicionar uma assinatura a um repositório GitHub Enterprise, você precisa ser um administrador desse repositório.

As contas do GitHub Enterprise devem ser configuradas antes de serem assinadas. Para fazer isso, siga as etapas abaixo:

1. Depois de acessar o canal Zoom Chat de sua escolha, você pode inserir o comando /githube connect.
   Seu chatbot do GitHub Enterprise enviará uma mensagem direta informando que sua mensagem foi enviada. Se você precisar autenticar sua conta, clique no link fornecido.

2. Um dos seguintes comandos pode ser usado para configurar seus repositórios:

   • conectar : O proprietário precisa conectar todos os repositórios que pertencem a ele.

   • conectar : É possível conectar um repositório a outro.

   • conectar : vários repositórios podem ser conectados juntos.

   • conectar : Há uma ramificação que precisa ser conectada.

3. Para concluir o processo de configuração, clique no link fornecido e preencha o formulário:

   • Nome: Nome da configuração é o nome da configuração.

   • Canal: Você pode escolher de qual canal deseja receber notificações nas configurações.

   • Projetos: há vários projetos sobre os quais você pode estar interessado em receber notificações.

   • Eventos: Commits, Issues e Pull Requests são os eventos para escolher. Os seguintes são atualmente suportados pelo sistema:

     • Envia um commit para o repositório e faz o commit

     • Um novo comentário foi adicionado ao commit

     • Abriu/fechou um pull request

     • Eu abri/fechei o problema

     • Um comentário novo/editado/excluído foi adicionado ao problema

4. Clique no botão Salvar configuração.
   As notificações agora serão enviadas para você de acordo com sua configuração.

Interaja com o chatbot do GitHub Enterprise

Você começará a receber notificações de bate-papo assim que adicionar uma assinatura e seu canal de bate-papo do Zoom tiver sido configurado para receber notificações de bate-papo.

Comandos disponíveis

comando de ajuda

Você pode encontrar uma lista de todos os comandos disponíveis digitando help.

Comando conectar

Clique no botão conectar para conectar seu repositório ou branch do GitHub Enterprise ao servidor.

Ao inserir este comando, você poderá se inscrever no canal em que inseriu o comando. Sua conta do GitHub Enterprise deve primeiro ser conectada para que você conecte seus repositórios.

Para corrigir a sintaxe utilizada, você verá uma mensagem assim que se conectar.

Se você conectar tanto um repositório quanto um branch abaixo dele, você poderá acessar apenas o repositório, deixando os branches fora da conexão. Não será possível conectar as ramificações deste repositório dentro do mesmo canal se você já conectou as ramificações de um repositório com o canal.

Comando de comentário

Adicionar um comentário a um problema é tão simples quanto digitá-lo. Existe uma sintaxe para comentários que você precisará seguir: (Shift+Enter)

Você vai precisar:

1. Deve haver um nome de repositório completo, bem como um ID de problema especificado.

2. Para iniciar uma nova linha, pressione Shift + Enter no teclado.

3. Fique à vontade para deixar um comentário abaixo.

Comando de desconexão

Digite desconectar no menu da conta do GitHub Enterprise para desconectar sua conta.

Desconectar a conexão de um proprietário de um canal resultará apenas na desconexão das conexões desse proprietário. O nome do repositório ou branch deve ser exatamente igual ao nome que você deseja desconectar para fazer então, para exemplo, você não pode usar desconectar proprietário/repositório para desconectar proprietário/repositório:branch.

Como remover o Chatbot do GitHub Enterprise

1. Você precisará fazer login com sua conta do Zoom para acessar Zoom Mercado de aplicativos.

2. Clique no botão Gerenciar na parte superior da página, que pode ser encontrado no canto direito.

3. Selecione os Adicionado Opção de aplicativos no menu de navegação na parte superior da página.

4. O GitHub Enterprise pode ser removido clicando no botão Remover ao lado dele.

5. Clique no botão Remover depois de confirmar a caixa de diálogo.

Segurança de dados

• Existem vários tipos de informações que este aplicativo pode acessar a partir do Zoom:

  • A conta Zoom permite que os usuários visualizem todos os grupos aos quais se inscreveram em seu Zoom contas.

  • A conta do Zoom permite visualizar os detalhes das reuniões existentes para um usuário do Zoom.

  • As informações de um usuário do Zoom podem ser visualizadas na conta do Zoom, se tiverem acesso a ela.

• Há informações no Github que podem ser acessadas por este aplicativo, incluindo as seguintes:

• O Zoom concede as seguintes permissões para que este aplicativo de bate-papo funcione:

  • Uma mensagem de bate-papo pode ser enviada por meio deste aplicativo de bate-papo para um usuário do Zoom ou para um canal de mensagens instantâneas em uma conversa de mensagens instantâneas.

  • Existe uma opção para configurar uma reunião do Zoom usando este aplicativo de bate-papo que pode ser usado por qualquer usuário do Zoom em uma conta do Zoom.

• Este aplicativo de bate-papo se comunica com o Zoom/Github por meio de um protocolo de criptografia seguro:

• Há várias credenciais armazenadas no armazenamento de dados local deste aplicativo de bate-papo:

O suporte do Zoom pode fornecer assistência adicional se você precisar.