Configure o gatilho da Web de Organização do GitHub para acionar uma ação sempre que um evento ocorrer na organização. Esse exemplo mostra como criar um Task Bot com o gatilho da Web de Organização do GitHub para exibir o texto do corpo de um item em uma caixa de mensagens.

Quando o proprietário do Token de acesso pessoal especificado nas configurações cria um item em qualquer repositório dentro da organização do GitHub especificada, o gatilho inicia a ação de Caixa de mensagens configurada.

Pré-requisitos

Certifique-se de cumprir os seguintes requisitos:
  • Licença e permissões mencionadas no Gatilhos da Web GitHub.
  • Um token de acesso pessoal do GitHub ativo armazenado como uma credencial no seu Cofre de credenciais.
  • Uma variável de registro chamada TriggerData.

Procedimento

  1. Execute as seguintes etapas para criar um Task Bot
    1. No painel da esquerda, clique em Automation (Automação).
    2. Clique em Criar > Task Bot.
      O assistente Criar bot de tarefa é exibido.
    3. Digite um nome apropriado para o bot no campo Nome.
      Todos os bots são armazenados na pasta <\Bots> por padrão.
    4. Opcional: Adicione uma descrição para o bot no campo Descrição.
    5. Opcional: Clique em Escolher e siga as instruções para salvar o bot em uma pasta diferente.
    6. Clique em Criar e editar.
      O bot é criado e a página Editar bot de tarefa é exibida.
  2. Execute as etapas a seguir para adicionar e configurar o gatilho de Organização do GitHub.
    1. Selecione Gatilhos > GitHub e clique duas vezes em Gatilho da Web de organização para adicionar o gatilho da Web.
    2. Selecione Itens no menu suspenso Monitorar evento.
    3. Insira o nome da organização no campo Nome da organização.
      O gatilho monitora o evento dessa organização.
    4. Selecione Token de acesso pessoal > Credencial e clique em Escolher.
      O gatilho ativará a ação subsequente somente se o usuário que possui esse Token de acesso pessoal criar o item.
    5. Siga as instruções no modal Escolher uma credencial e escolha o Token de acesso pessoal armazenado no Cofre de credenciais.
    6. Selecione TriggerData na lista suspensa Resposta.
      Essa variável de registro captura os dados de resposta do gatilho sobre o evento em que a alteração ocorreu no formato de pares de chave-valor.
  3. Execute as seguintes etapas para adicionar e configurar a ação Caixa de mensagem.
    1. Clique em Ações > Caixa de mensagens e adicione a ação Caixa de mensagem.
    2. Digite um título apropriado para a caixa de mensagens em Insira o título da janela da caixa de mensagens.
    3. Digite $TriggerData{issue.body}$ em Digite a mensagem a ser exibida.
      A chave issue.body dos dados de resposta do gatilho contém o corpo do item criado como o valor correspondente.
  4. Clique em Salvar para salvar a configuração.
Ao clicar em Executar > Executar com gatilhos, o sistema ativa o gatilho, que começa a monitorar eventos de Itens na organização do GitHub especificada. Quando um usuário cria um item em qualquer repositório dentro da organização, o gatilho inicia a ação Caixa de mensagem. A caixa de mensagens exibe o texto do corpo do item criado.