Sobre os tipos de webhook
Um webhook só pode acessar eventos que estejam disponíveis no repositório, na organização, na GitHub Marketplace conta, na GitHub Sponsors conta, em ou em GitHub App na qual está instalado.
Não é possível criar webhooks para contas de usuário individuais ou para eventos específicos dos recursos do usuário, como menções ou notificações pessoais.
Para criar e gerenciar webhooks, você deve ser proprietário ou ter acesso de administrador ao recurso em que o webhook é criado e está ouvindo eventos. Por exemplo, para gerenciar webhooks em uma organização, você precisa de permissões de administrador para essa organização.
Alguns eventos de webhook são exclusivos para determinados tipos de webhooks. Por exemplo, um webhook de organização pode se registrar para eventos que ocorrem apenas no nível da organização, enquanto um webhook de repositório não pode fazê-lo. Para obter mais informações sobre a disponibilidade específica de cada webhook, confira Eventos e cargas de webhook.
Para saber mais, confira Sobre webhooks.
Webhooks do repositório
Você pode criar webhooks em um repositório para assinar eventos que ocorrem nesse repositório. Você deve ser proprietário do repositório ou ter acesso de administrador no repositório para criar e gerenciar webhooks em um repositório. Não é possível criar, editar ou excluir webhooks em um repositório em que você não tem as permissões necessárias.
Você pode criar vários webhooks em um único repositório. No entanto, você só pode criar até 20 webhooks que se inscrevem em cada tipo de evento individualmente. Por exemplo, em um único repositório, você só poderia criar até 20 webhooks diferentes, cada um configurado para o evento push.
Você pode usar a interface web do GitHub ou a API REST para gerenciar webhooks do repositório. Para saber mais, confira Criação de webhooks, Editando webhooks e Desativar webhooks. Para obter mais informações sobre como usar a API REST para gerenciar webhooks de repositório, confira Pontos de extremidade da API REST para webhooks de repositório.
Webhooks da organização
Você pode criar webhooks em uma organização para assinar eventos que ocorrem nessa organização. Os webhooks da organização podem assinar eventos que acontecem em todos os repositórios de propriedade da organização. Eles também podem assinar eventos que acontecem no nível da organização e estão fora de qualquer repositório específico, como quando um novo membro é adicionado à organização.
Você deve ser proprietário de uma organização para criar e gerenciar webhooks nela.
Você pode criar vários webhooks em uma única organização. No entanto, você só pode criar até 20 webhooks que se inscrevem em cada tipo de evento. Por exemplo, em uma única organização, você só poderia criar até 20 webhooks diferentes, cada um inscrito no evento push.
Você pode usar a GitHub interface web ou a API REST para gerenciar webhooks da organização. Para saber mais, confira Criação de webhooks, Editando webhooks e Desativar webhooks. Para obter mais informações sobre como usar a API REST para gerenciar webhooks da organização, confira Pontos de extremidade de API REST para webhooks da organização.
GitHub Marketplace webhooks
Você pode criar um webhook para se inscrever em eventos relacionados a um app que você publicou em GitHub Marketplace. Você só pode criar um webhook para cada aplicativo em GitHub Marketplace. Somente o proprietário do aplicativo ou um gerenciador de aplicativos com acesso ao aplicativo pode criar e gerenciar um GitHub Marketplace webhook.
Não é possível excluir um GitHub Marketplace webhook, mas você pode desativá-lo para parar de receber entregas de webhook.
Você pode usar a interface web GitHub para gerenciar um GitHub Marketplace webhook. Para saber mais, confira Criação de webhooks, Editando webhooks e Desativar webhooks.
GitHub Sponsors webhooks
Você pode criar webhooks para assinar eventos relacionados a GitHub Sponsors. Você só pode criar até 20 webhooks para uma GitHub Sponsors conta.
Você deve ser proprietário de uma conta ou ter acesso de administrador na conta patrocinada para gerenciar webhooks de patrocínio.
Você pode usar a interface web GitHub para gerenciar os webhooks GitHub Sponsors. Para saber mais, confira Criação de webhooks, Editando webhooks e Desativar webhooks.
GitHub App webhooks
Você pode configurar um GitHub App para receber webhooks quando eventos específicos ocorrerem em um repositório ou organização ao qual o aplicativo recebeu acesso.
Cada GitHub App tem um único webhook que é criado automaticamente por GitHub. Por padrão, o webhook não é inscrito em nenhum evento. Você pode configurar os eventos aos quais o webhook se inscreve. Não é possível excluir um GitHub App webhook, mas você pode desativá-lo para parar de receber entregas de webhook.
Você pode usar a interface da GitHub Web ou a API REST para gerenciar um GitHub App webhook. Para saber mais, confira Criação de webhooks, Editando webhooks e Desativar webhooks. Para obter mais informações sobre como usar a API REST para gerenciar GitHub App webhooks, consulte Pontos de extremidade da API REST para GitHub App webhooks.