Skip to main content

Criar webhooks

Você pode criar webhooks para assinar eventos específicos que ocorrem em GitHub.

Sobre a criação de webhooks

Você pode criar webhooks para assinar eventos específicos no GitHub que ocorrem em um repositório, organização, conta GitHub Enterprise, GitHub Marketplace, conta GitHub Sponsors, ou GitHub App.

Para obter mais informações sobre os diferentes tipos de webhooks, confira "Tipos de webhooks".

Para obter uma lista completa de eventos de webhooks, confira "Eventos e cargas de webhook".

Criar um webhook de um repositório

Você pode criar um webhook para assinar eventos que ocorrem em um repositório específico. Você deve ser proprietário de um repositório ou ter acesso de administrador no repositório para criar webhooks nesse repositório.

Você pode usar a interface da Web GitHub ou a API REST para criar um webhook de repositório. Para obter mais informações sobre como usar a API REST para criar um webhook de repositório, consulte "Pontos de extremidade da API REST para webhooks de repositório".

  1. No GitHub.com, navegue até a página principal do repositório.

  2. Abaixo do nome do repositório, clique em Configurações. Caso não consiga ver a guia "Configurações", selecione o menu suspenso , clique em Configurações.

    Captura de tela de um cabeçalho de repositório que mostra as guias. A guia "Configurações" é realçada por um contorno laranja-escuro.

  3. Na barra lateral esquerda, clique em Webhooks.

  4. Clique em Adicionar webhook.

  5. Em "URL de conteúdo", digite a URL em você gostaria de receber conteúdo.

  6. Opcionalmente, selecione o menu suspenso Tipo de conteúdo e clique em um formato de dados no qual o conteúdo do webhook será recebido.

    • application/json entregará o conteúdo JSON diretamente como o corpo da solicitação POST.
    • application/x-www-form-urlencoded enviará o conteúdo JSON como um parâmetro de formulário chamado payload.
  7. Opcionalmente, em "Segredo", digite uma cadeia de caracteres para usar como chave secret. Você deve escolher uma cadeia de caracteres aleatória de texto com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações recebidas apenas àquelas originadas de GitHub. Para obter mais informações, confira "Validação de entregas de webhooks".

  8. Em "Em quais eventos você gostaria de disparar este webhook?", selecione os eventos de webhook que você deseja receber. Você só deve se inscrever nos eventos de webhook de que necessita.

  9. Se você escolher Deixe-me selecionar eventos individuais, selecione os eventos que deseja que disparem o webhook.

  10. Para tornar o webhook ativo imediatamente após adicionar a configuração, selecione Ativo.

  11. Clique em Adicionar webhook.

Depois que você criar um novo webhook, GitHub lhe enviará um evento ping simples para que você saiba que configurou o webhook corretamente. Para obter mais informações, confira "Eventos e cargas de webhook".

Criar um webhook de uma organização

Você pode criar um webhook para assinar eventos que ocorrem em uma organização específica. Você deve ser proprietário de uma organização para criar webhooks nela.

Você pode usar a interface da Web GitHub ou a API REST para criar um webhook da organização. Para obter mais informações sobre como usar a API REST para criar um webhook da organização, consulte "Pontos de extremidade de API REST para webhooks da organização".

  1. No canto superior direito de qualquer página do GitHub.com, clique na foto de seu perfil.
  2. Clique em Suas organizações.
  3. À direita da organização, clique em Configurações.
  4. Na barra lateral esquerda, clique em Webhooks.
  5. Clique em Adicionar webhook.
  6. Em "URL de conteúdo", digite a URL em você gostaria de receber conteúdo.
  7. Opcionalmente, selecione o menu suspenso Tipo de conteúdo e clique em um formato de dados no qual o conteúdo do webhook será recebido.
    • application/json entregará o conteúdo JSON diretamente como o corpo da solicitação POST.
    • application/x-www-form-urlencoded enviará o conteúdo JSON como um parâmetro de formulário chamado payload.
  8. Opcionalmente, em "Segredo", digite uma cadeia de caracteres para usar como chave secret. Você deve escolher uma cadeia de caracteres aleatória de texto com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações recebidas apenas àquelas originadas de GitHub. Para obter mais informações, confira "Validação de entregas de webhooks".
  9. Em "Em quais eventos você gostaria de disparar este webhook?", selecione os tipos de webhooks que você gostaria de receber. Você só deve se inscrever nos eventos de webhook de que necessita.
  10. Se você escolher Deixe-me selecionar eventos individuais, selecione os eventos que dispararão o webhook.
  11. Para tornar o webhook ativo imediatamente após adicionar a configuração, selecione Ativo.
  12. Clique em Adicionar webhook.

Depois que você criar um novo webhook, GitHub lhe enviará um evento ping simples para que você saiba que configurou o webhook corretamente. Para obter mais informações, confira "Eventos e cargas de webhook".

Criar um webhook global para um GitHub Enterprise

Os proprietários de empresas podem criar um webhook global para assinar eventos que ocorrem em sua empresa.

  1. No canto superior direito do GitHub.com, clique na foto do seu perfil e em Suas empresas.

  2. Na lista de empresas, clique na empresa que você deseja visualizar.

  3. Na barra lateral da conta corporativa, clique em Configurações.

  4. Em " Configurações", clique em Ganchos.

  5. Clique em Adicionar webhook.

  6. No campo "URL de conteúdo", digite a URL em que deseja receber o conteúdo.

  7. Opcionalmente, selecione o menu suspenso Tipo de conteúdo e clique em um formato de dados no qual o conteúdo do webhook será recebido.

    • application/json entregará o conteúdo JSON diretamente como o corpo da solicitação POST.
    • application/x-www-form-urlencoded enviará o conteúdo JSON como um parâmetro de formulário chamado payload.
  8. Opcionalmente, em "Segredo", digite uma cadeia de caracteres para usar como chave secret. Você deve escolher uma cadeia de caracteres aleatória de texto com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações recebidas apenas àquelas originadas de GitHub. Para obter mais informações, confira "Validação de entregas de webhooks".

  9. Opcionalmente, se a URL de conteúdo for HTTPS e você não quiser que o GitHub Enterprise Server verifique os certificados SSL ao fornecer o conteúdo, selecione Desabilitar em "Verificação de SSL". Leia as informações sobre a verificação de SSL e clique em Desabilitar. Entendi que os meus webhooks podem não estar seguros.

    Aviso: a verificação SSL ajuda a garantir que o conteúdo do gancho seja entregue com segurança. Não é recomendável desabilitar a verificação SSL.

  10. Em "Em quais eventos você gostaria de disparar este webhook?", selecione os tipos de webhooks que você gostaria de receber. Você só deve se inscrever nos eventos de webhook de que necessita.

  11. Se você escolher Deixe-me selecionar eventos individuais, selecione os eventos que dispararão o webhook.

  12. Para tornar o webhook ativo imediatamente após adicionar a configuração, selecione Ativo.

  13. Clique em Adicionar webhook.

Criar um webhook do GitHub Marketplace

Você pode criar um webhook para assinar eventos relacionados a um aplicativo publicado em GitHub Marketplace. Somente o proprietário do aplicativo ou um gerente de aplicativo da organização proprietária do aplicativo podem criar um webhook do GitHub Marketplace.

  1. Navegue até sua página de listagem de GitHub Marketplace.
  2. Ao lado da listagem de GitHub Marketplace cujas entregas de webhook você deseja visualizar, clique em Gerenciar listagem.
  3. Na barra lateral, clique em Webhook.
  4. Em "URL de conteúdo", digite a URL em você gostaria de receber conteúdo.
  5. Opcionalmente, selecione o menu suspenso Tipo de conteúdo e clique em um formato de dados no qual o conteúdo do webhook será recebido.
    • application/json entregará o conteúdo JSON diretamente como o corpo da solicitação POST.
    • application/x-www-form-urlencoded enviará o conteúdo JSON como um parâmetro de formulário chamado payload.
  6. Opcionalmente, em "Segredo", digite uma cadeia de caracteres para usar como chave secret. Você deve escolher uma cadeia de caracteres aleatória de texto com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações recebidas apenas àquelas originadas de GitHub. Para obter mais informações, confira "Validação de entregas de webhooks".
  7. Para tornar o webhook ativo imediatamente após adicionar a configuração, selecione Ativo.
  8. Clique em Criar webhook.

Depois que você criar um novo webhook, GitHub lhe enviará um evento ping simples para que você saiba que configurou o webhook corretamente. Para obter mais informações, confira "Eventos e cargas de webhook".

Criar um webhook do GitHub Sponsors

Você pode criar um webhook para se inscrever em eventos relacionados aos seus patrocínios. Somente o proprietário da conta patrocinada pode criar webhooks de patrocínio para essa conta. Para obter mais informações sobre o evento no qual um webhook de patrocínio está inscrito, consulte o webhook de evento sponsorship.

  1. No canto superior direito de qualquer página, clique na foto do seu perfil e em Seus patrocinadores.
  2. Ao lado da conta cujas para a qual você deseja criar um webhook, clique em Painel.
  3. Na barra lateral esquerda, clique em Webhooks.
  4. Clique em Adicionar webhook.
  5. Em "URL de conteúdo", digite a URL em você gostaria de receber conteúdo.
  6. Opcionalmente, selecione o menu suspenso Tipo de conteúdo e clique em um formato de dados no qual o conteúdo do webhook será recebido.
    • application/json entregará o conteúdo JSON diretamente como o corpo da solicitação POST.
    • application/x-www-form-urlencoded enviará o conteúdo JSON como um parâmetro de formulário chamado payload.
  7. Opcionalmente, em "Segredo", digite uma cadeia de caracteres para usar como chave secret. Você deve escolher uma cadeia de caracteres aleatória de texto com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações recebidas apenas àquelas originadas de GitHub. Para obter mais informações, confira "Validação de entregas de webhooks".
  8. Para tornar o webhook ativo imediatamente após adicionar a configuração, selecione Ativo.
  9. Clique em Criar webhook.

Criar webhooks para um GitHub App

O proprietário de um GitHub App pode inscrever o aplicativo em eventos de webhook para receber notificações sempre que determinados eventos ocorrerem. Se uma organização tiver designado gerentes de aplicativos para um GitHub App de propriedade da organização, os gerentes de aplicativos também poderão inscrever o aplicativo em eventos de webhook. Para obter mais informações, confira "Usar webhooks com aplicativos GitHub".

Cada GitHub App tem um webhook. Você pode configurar o webhook ao registrar um GitHub App ou pode editar a configuração do webhook para um registro existente do GitHub App.

Para obter mais informações sobre como configurar um webhook ao registrar um GitHub App, confira "Registrar um Aplicativo GitHub".

Para configurar um webhook para um registro do GitHub App existente:

  1. No canto superior direito de qualquer página do GitHub, clique na foto do seu perfil.

  2. Acesse as configurações da sua conta.

    • Para um aplicativo de propriedade de uma conta pessoal, clique em Configurações.
    • Para um aplicativo de propriedade de uma organização:
      1. Clique em Suas organizações.
      2. À direita da organização, clique em Configurações.
  3. Na barra lateral esquerda, clique em Configurações do desenvolvedor.

  4. Na barra lateral esquerda, clique em GitHub Apps .

  5. Junto ao GitHub App para o qual você deseja configurar um webhook, clique em Editar.

  6. Em "Webhook", selecione Ativo.

  7. Em "URL do webhook", digite a URL na qual você gostaria de receber conteúdo.

  8. Opcionalmente, em "Segredo do webhook", digite uma cadeia de caracteres para usar como chave secret. Você deve escolher uma cadeia de caracteres aleatória de texto com alta entropia. Você pode usar o segredo do webhook para limitar as solicitações recebidas apenas àquelas originadas de GitHub. Para obter mais informações, confira "Validação de entregas de webhooks".

  9. Selecione Salvar alterações.

  10. Na barra lateral, clique em Permissões e eventos.

  11. Os eventos de webhook específicos que você pode selecionar no registro do GitHub App são determinados pelo tipo de permissões selecionado para seu aplicativo. Primeiro, você precisará selecionar as permissões que deseja que seu aplicativo tenha e depois assinar o aplicativo em eventos de webhook relacionados a esse conjunto de permissões.

    Nas seções "Permissões do repositório", "Permissões da organização" e "Permissões da conta", selecione as permissões necessárias para os eventos aos quais seu aplicativo se inscreverá. Para obter mais informações, confira "Escolhendo permissões para um Aplicativo GitHub". Para obter mais informações sobre o que considerar ao alterar as permissões, consulte "Modificando um registro do GitHub App”.

  12. Em "Inscrever-se em eventos", selecione os eventos de webhook que você deseja que o GitHub App receba.

  13. Clique em Salvar alterações.

Você também pode usar a API REST para criar um webhook para um GitHub App. Para obter mais informações, confira "Pontos de extremidade da API REST de webhooks do GitHub App".

Leitura adicional