{"meta":{"title":"Personalizando notificações para GitHub no Slack","intro":"Saiba como personalizar notificações para GitHub no Slack.","product":"Integrations","breadcrumbs":[{"href":"/pt/integrations","title":"Integrations"},{"href":"/pt/integrations/how-tos","title":"How-tos"},{"href":"/pt/integrations/how-tos/slack","title":"Slack"},{"href":"/pt/integrations/how-tos/slack/customize-notifications","title":"Personalizar notificações"}],"documentType":"article"},"body":"# Personalizando notificações para GitHub no Slack\n\nSaiba como personalizar notificações para GitHub no Slack.\n\nVocê pode personalizar suas notificações inscrevendo-se em atividades relevantes para o canal do Slack e desinscrevendo-se das atividades menos relevantes para o seu projeto.\n\n### Notificações habilitadas por padrão\n\nAs notificações a seguir são habilitadas por padrão, mas você pode desabilitar qualquer uma delas usando o comando `/github unsubscribe OWNER/REPO [EVENT]`.\n\n| Event         | Description                                                                                              |\n| ------------- | -------------------------------------------------------------------------------------------------------- |\n| `issues`      | Problemas abertos, fechados ou reabertos.                                                                |\n| `pulls`       | Solicitações pull novas ou mescladas e solicitações pull de rascunho marcadas como prontas para revisão. |\n| `commits`     | Novas confirmações na ramificação padrão.                                                                |\n| `releases`    | Versões publicadas.                                                                                      |\n| `deployments` | Atualizações de status de implantação.                                                                   |\n\n### Notificações desabilitadas por padrão\n\nAs notificações a seguir são desabilitadas por padrão, mas você pode habilitar qualquer uma delas usando o comando `/github subscribe OWNER/REPO [EVENT]`.\n\n| Event                 | Description                                                          |\n| --------------------- | -------------------------------------------------------------------- |\n| `reviews`             | Revisões de Pull Request.                                            |\n| `workflows`           | Execuções de workflows de ações                                      |\n| `branches`            | Criação ou exclusão de branches.                                     |\n| `comments`            | Novos comentários em problemas ou pull requests.                     |\n| `commits`             | Todas as confirmações em qualquer ramificação.                       |\n| `discussions`         | Discussões criadas ou respondidas.                                   |\n| `+label:\"YOUR-LABEL\"` | Problemas, solicitações pull e comentários com base em seus rótulos. |\n\nVocê pode assinar ou cancelar a assinatura de várias configurações ao mesmo tempo. Por exemplo:\n\n* Para ativar a atividade de avaliações e comentários de solicitações pull, use `/github subscribe OWNER/REPO reviews comments`.\n* Para desativar a atividade de problemas e solicitações pull, use `/github unsubscribe OWNER/REPO issues pulls`.\n\n## Filtrando notificações\n\nVocê pode personalizar ainda mais suas notificações com filtros de branch e etiqueta. Os filtros de ramificação permitem filtrar as notificações de confirmações com base nos nomes das ramificações, enquanto os filtros de rótulo permitem filtrar as notificações de problemas e solicitações pull com base nos rótulos aplicados a elas.\n\n### Filtros de ramificação para notificações de confirmação\n\nOs filtros de ramificação permitem filtrar as notificações de confirmação com base nos nomes das ramificações. Por padrão, ao se inscrever no evento `commits`, você receberá notificações para sua ramificação padrão. No entanto, você pode optar por filtrar por uma ramificação específica, um padrão de ramificações ou todas as ramificações.\n\n| Configuração de exemplo                          | Description                                                                               |\n| ------------------------------------------------ | ----------------------------------------------------------------------------------------- |\n| `/github subscribe OWNER/REPO commits`           | Receba notificações de confirmação para a ramificação padrão.                             |\n| `/github subscribe OWNER/REPO commits:main`      | Receba notificações de confirmação apenas para a ramificação `main`.                      |\n| `/github subscribe OWNER/REPO commits:feature/*` | Receba notificações de confirmação para todas as ramificações que começam com `feature/`. |\n| `/github subscribe OWNER/REPO commits:*`         | Receba notificações de confirmação para todas as ramificações.                            |\n\n> \\[!NOTE] Você pode ter usado anteriormente o filtro `commits:all` para receber notificações de confirmação para todas as ramificações. Esse filtro é encerrando. Para receber notificações de confirmação para todas as ramificações, use o filtro `commits:*`. Se você tiver configurado o `commits:all` filtro anteriormente, ele continuará funcionando até que você atualize sua configuração para usar o `commits:*` filtro.\n\n### Filtros de rótulos para notificações de problemas e solicitações pull\n\nOs filtros de rótulo permitem filtrar notificações com base em rótulos aplicados a problemas e solicitações de pull. Quando um filtro de rótulo é definido, somente notificações para eventos, incluindo o rótulo especificado, serão enviadas. Para obter mais informações sobre rótulos, consulte [Gerenciar etiquetas](/pt/issues/using-labels-and-milestones-to-track-work/managing-labels) e [Filtrando e pesquisando problemas e pull requests](/pt/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests).\n\nAtualmente, só é possível ter um filtro de rótulo necessário por repositório. A tabela abaixo mostra quais tipos de evento são afetados por filtros de rótulo.\n\n| Tipo de evento       | É filtrado por rótulo                                                                                                                                                                                                                                                                                                                                                                                                              |\n| -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Solicitações de pull | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-check\" aria-label=\"Included\" role=\"img\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"></path></svg>                                                                                                            |\n| Problemas            | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-check\" aria-label=\"Included\" role=\"img\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"></path></svg>                                                                                                            |\n| Comments             | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-check\" aria-label=\"Included\" role=\"img\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"></path></svg>                                                                                                            |\n| Reviews              | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-check\" aria-label=\"Included\" role=\"img\"><path d=\"M13.78 4.22a.75.75 0 0 1 0 1.06l-7.25 7.25a.75.75 0 0 1-1.06 0L2.22 9.28a.751.751 0 0 1 .018-1.042.751.751 0 0 1 1.042-.018L6 10.94l6.72-6.72a.75.75 0 0 1 1.06 0Z\"></path></svg>                                                                                                            |\n| Confirmações/pushes  | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-x\" aria-label=\"Not included\" role=\"img\"><path d=\"M3.72 3.72a.75.75 0 0 1 1.06 0L8 6.94l3.22-3.22a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734L9.06 8l3.22 3.22a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L8 9.06l-3.22 3.22a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L6.94 8 3.72 4.78a.75.75 0 0 1 0-1.06Z\"></path></svg> |\n| Ramificações         | <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-x\" aria-label=\"Not included\" role=\"img\"><path d=\"M3.72 3.72a.75.75 0 0 1 1.06 0L8 6.94l3.22-3.22a.749.749 0 0 1 1.275.326.749.749 0 0 1-.215.734L9.06 8l3.22 3.22a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L8 9.06l-3.22 3.22a.751.751 0 0 1-1.042-.018.751.751 0 0 1-.018-1.042L6.94 8 3.72 4.78a.75.75 0 0 1 0-1.06Z\"></path></svg> |\n\n#### Criando filtros de rótulo\n\nPara criar um filtro de rótulo, use o seguinte formato de comando:\n\n```text copy\n/github subscribe [OWNER/REPO] +label:\"YOUR-LABEL\"\n```\n\nIsso cria um filtro de rótulo obrigatório com o valor `YOUR-LABEL`. Os eventos de entrada que dão suporte a filtros são descartados, a menos que tenham esse rótulo.\n\n#### Atualizando filtros de rótulo\n\nVocê pode atualizar um filtro de rótulo existente especificando um novo valor de rótulo:\n\n```text copy\n/github subscribe [OWNER/REPO] +label:\"NEW-LABEL\"\n```\n\nIsso substituirá o filtro \"YOUR-LABEL\" pelo filtro \"NEW-LABEL\".\n\n#### Removendo filtros de rótulo\n\nVocê pode remover um filtro de rótulo existente usando o comando cancelar assinatura com a opção `+label` :\n\n```text copy\n/github unsubscribe [OWNER/REPO] +label:\"NEW-LABEL\"\n```\n\nIsso removerá o filtro \"NEW-LABEL\" e o canal receberá todas as notificações para os eventos assinados sem nenhuma filtragem de rótulo.\n\n#### Exibindo filtros de rótulo ativos\n\nPara exibir os filtros de rótulo atualmente ativos para um canal, use o seguinte comando:\n\n```text copy\n/github subscribe list features\n```\n\n#### Filtros válidos\n\nO GitHub aplicativo no Slack dá suporte aos caracteres especiais mais comuns para filtros de rótulo, incluindo todos os emojis que o Slack e GitHub fornecem como padrão. Raramente, você pode encontrar um rótulo que contém um caractere especial que não tem suporte. Por exemplo, qualquer caractere multibyte não codificado como `:foo:`, ou rótulos usando o caractere `,` podem não funcionar conforme esperado.\n\n## Notificações do fluxo de trabalho de ações\n\nVocê pode assinar as notificações de execução de workflow do GitHub Actions direto do seu canal ou aplicativo pessoal usando o recurso \"workflows\", no formato `/github subscribe OWNER/REPO workflows`.\n\nQuando você estiver inscrito em \"fluxos de trabalho\", a seguinte funcionalidade estará disponível:\n\n* Você será notificado quando uma nova execução de fluxo de trabalho for disparada.\n\n* Você pode acompanhar as notificações de aprovação como uma resposta no thread e aprovar as notificações diretamente do canal/aplicativo pessoal.\n\n* Depois que o fluxo de trabalho for concluído, você receberá uma atualização como resposta no thread para que você possa concluir o contexto e o histórico sobre a execução do fluxo de trabalho.\n\n* Se algo falhar, você pode optar por executar o workflow novamente no local e também pode habilitar logs de depuração, se necessário.\n\n> \\[!NOTE] Após 2025-03-10 (GHES versão 3.17), você não será mais notificado sobre o progresso de trabalhos individuais de fluxo de trabalho. Consulte o [GitHub registro de alterações](https://github.blog/changelog/2025-02-03-deprecation-of-real-time-github-actions-workflow-job-events-in-slack-and-microsoft-teams-apps/) para obter mais detalhes.\n\n### Filtros de notificação de fluxo de trabalho\n\nVocê pode filtrar notificações de fluxo de trabalho usando as seguintes opções:\n\n| Filter   | Description                                                                                                                                                                                                                 |\n| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `name`   | Filtre pelo nome do fluxo de trabalho.                                                                                                                                                                                      |\n| `actor`  | Filtrar pelo usuário que disparou o fluxo de trabalho.                                                                                                                                                                      |\n| `branch` | Filtre pelo branch em que o fluxo de trabalho está sendo executado. Nos casos em que o evento `pull_request` está incluído, a ramificação será a ramificação de destino para a qual a solicitação de pull request é criada. |\n| `event`  | Filtre pelo evento que disparou o fluxo de trabalho (por exemplo, push, pull\\_request).                                                                                                                                     |\n\nVocê pode configurar filtros de notificação de fluxo de trabalho com o seguinte formato:\n\n```text copy\n/github subscribe OWNER/REPO workflows:{name:\"YOUR-WORKFLOW-NAME\" event:\"WORKFLOW-EVENT\" branch:\"BRANCH-NAME\" actor:\"USERNAME\"}\n```\n\nVocê também pode passar vários valores para cada filtro, separados por vírgulas. Por exemplo:\n\n```text copy\n/github subscribe OWNER/REPO workflows:{name:\"YOUR-WORKFLOW-NAME\",\"ANOTHER-WORKFLOW-NAME\" event:\"WORKFLOW-EVENT\",\"ANOTHER-WORKFLOW-EVENT\" branch:\"BRANCH-NAME\",\"ANOTHER-BRANCH-NAME\" actor:\"USERNAME\",\"ANOTHER-USERNAME\"}\n```\n\nPor padrão, quando você configura as notificações de fluxo de trabalho sem aplicar filtros, elas são configuradas para fluxos de trabalho disparados por meio de solicitações pull request direcionadas ao seu branch padrão. Você pode inserir uma ou várias entradas.\n\nVocê pode cancelar a assinatura de notificações de fluxo de trabalho usando o comando: `/github unsubscribe OWNER/REPO workflows`.\n\n> \\[!NOTE] Para receber GitHub Actions notificações no Slack, o GitHub aplicativo requer permissões adicionais. Ao tentar assinar os fluxos de trabalho pela primeira vez, você será solicitado a conceder essas permissões.\n\n## Notificações de implantação\n\nVocê também pode configurar notificações de implantação separadas. Essas implantações podem ser feitas a partir de GitHub Actions ou de fontes externas por meio da API de implantações. Confira [Pontos de extremidade da API REST para implantações](/pt/rest/deployments/deployments?apiVersion=2022-11-28).\n\nVocê pode assinar ou cancelar a assinatura de notificações de implantação usando o comando: `/github subscribe/unsubscribe OWNER/REPO deployments`.\n\n> \\[!NOTE] Se você estiver usando GitHub Actions e quiser acompanhar suas implantações em ambientes, o `workflows` recurso será recomendado, pois ele fornece uma imagem mais completa e a capacidade de aprovar suas implantações diretamente do Slack."}