As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Filtrar eventos de webhook do Bitbucket
<a name="bitbucket-webhook"></a>

Você pode usar grupos de filtros de webhook para especificar quais eventos de webhook do Bitbucket acionam uma compilação. Por exemplo, é possível especificar que uma compilação seja acionada somente para alterações em ramificações especificadas. 

Você pode criar um ou mais grupos de filtros de webhook para especificar quais eventos de webhook acionam uma compilação. Uma compilação será acionada se algum grupo de filtros for avaliado como verdadeiro, o que ocorre quando todos os filtros no grupo são avaliados como verdadeiros. Ao criar um grupo de filtros, é necessário especificar: 

**Um evento**  
Para o Bitbucket, é possível escolher um ou mais dos seguintes eventos:  
+ `PUSH`
+ `PULL_REQUEST_CREATED`
+ `PULL_REQUEST_UPDATED`
+ `PULL_REQUEST_MERGED`
+ `PULL_REQUEST_CLOSED`
O tipo de evento do webhook está em seu cabeçalho no campos `X-Event-Key`. A tabela a seguir mostra como valores de cabeçalho `X-Event-Key` são mapeados para os tipos de eventos.  
Você deve habilitar o evento `merged` em sua configuração de webhook do Bitbucket caso você crie um grupo de filtros de webhook que use o tipo de evento `PULL_REQUEST_MERGED`. Você também deve habilitar o evento `declined` em sua configuração de webhook do Bitbucket caso você crie um grupo de filtros do webhook que usa o tipo de evento `PULL_REQUEST_CLOSED`.    
[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/codebuild/latest/userguide/bitbucket-webhook.html)
Para `PULL_REQUEST_MERGED`, se uma solicitação pull for mesclada com a estratégia squash e a ramificação da solicitação pull for fechada, a confirmação original da solicitação pull deixará de existir. Nesse caso, a variável de ambiente `CODEBUILD_WEBHOOK_MERGE_COMMIT` contém o identificador da confirmação de mesclagem comprimida.

**Um ou mais filtros opcionais**  
Use uma expressão regular para especificar um filtro. Para um evento acionar uma compilação, cada filtro do grupo associado a ele deve ser avaliado como verdadeiro.    
`ACTOR_ACCOUNT_ID` (`ACTOR_ID` no console)  
Um evento de webhook aciona uma compilação quando um ID de conta do Bitbucket corresponde ao padrão da expressão regular. Esse valor é exibido na propriedade `account_id` do objeto `actor` na carga de filtro webhook.  
`HEAD_REF`  
Um evento de webhook aciona uma compilação quando a referência head corresponde ao padrão da expressão regular (por exemplo, `refs/heads/branch-name` e `refs/tags/tag-name`). Um filtro `HEAD_REF` avalia o nome de referência do Git para a ramificação ou tag. O nome de ramificação ou de tag é exibido no campo `name` do objeto `new` no objeto `push` da carga webhook. Para eventos de solicitação pull, o nome da ramificação é exibido no campo `name` no objeto `branch` do objeto `source` na carga webhook.  
`BASE_REF`  
Um evento de webhook aciona uma compilação quando a referência base corresponde ao padrão da expressão regular. Um filtro `BASE_REF` funciona apenas com eventos de solicitação pull (por exemplo, `refs/heads/branch-name`). Um filtro `BASE_REF` avalia o nome de referência do Git para a ramificação. O nome da ramificação é exibido no campo `name` do objeto `branch` no objeto `destination` na carga webhook.  
`FILE_PATH`  
Um evento de webhook aciona uma compilação quando o caminho de um arquivo alterado corresponde ao padrão da expressão regular.  
`COMMIT_MESSAGE`  
Um webhook aciona uma compilação quando a mensagem de confirmação head corresponde à expressão padrão.  
`WORKFLOW_NAME`  
Um webhook aciona uma compilação quando o nome do fluxo de trabalho corresponde ao padrão da expressão regular.

**nota**  
Você pode encontrar a carga webhook nas configurações de webhook no seu repositório do Bitbucket. 

**Topics**
+ [Filtrar eventos de webhook do Bitbucket (console)](bitbucket-webhook-events-console.md)
+ [Filtrar eventos de webhook do Bitbucket (SDK)](bitbucket-webhook-events-sdk.md)
+ [Filtrar eventos de webhook do Bitbucket (CloudFormation)](bitbucket-webhook-events-cfn.md)