> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Visão geral do painel Webhooks do PlayFab no Game Manager, incluindo como acessá-lo e configurar um ponto de extremidade de webhook para encaminhar dados de eventos para o seu servidor.

<Note>
  Recomendamos usar as [Regras de Automação](/pt-BR/services/playfab/data-analytics/acting-data/action-rules-quickstart) em vez dos Webhooks, pois as Regras de Automação oferecem suporte a ações V2 e fornecem a mesma funcionalidade que os Webhooks.
</Note>

Em sistemas complexos, talvez você queira fornecer tratamento de eventos adicional no seu servidor personalizado. Para isso, o PlayFab oferece os Webhooks.

Sempre que um novo evento é emitido, ele pode ser encaminhado para o seu servidor por meio de uma solicitação POST para o seu ponto de extremidade da Web personalizado. Os dados do evento são então passados como o corpo JSON da solicitação.

<Info>
  Os Eventos do PlayStream de Entidade não oferecerão suporte ao encaminhamento com Webhooks.
</Info>

## Acessando os Webhooks

Para acessar o painel **Webhooks** na tela do **Game Manager** do PlayFab:

1. Selecione **Data** no menu da barra lateral.
2. Em seguida, escolha a guia **Webhooks**.

## Visão geral do painel Webhooks

A imagem mostrada abaixo fornece uma visão geral do painel **Webhooks**.

1. O botão **New Webhook** permite que você crie e configure um novo Webhook.
2. A área **Webhook Name** pode ser usada para acessar e configurar o Webhook.
3. A área **Status** mostra se um Webhook está **habilitado** no momento.
4. A área **Failing Since** mostra quando um ponto de extremidade de Webhook parou de retornar respostas **OK**.
5. Quando um ou mais Webhooks estão selecionados, você pode usar o botão **Delete** para removê-los permanentemente.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/Webhook-Landing.PNG?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=c574b5208aa05816dd5a86e23023fea9" alt="Game Manager - Dados - Painel Webhooks" width="1366" height="920" data-path="images/playfab/data-analytics/acting-data/Webhook-Landing.PNG" />

## Configurando um Webhook

A imagem mostrada abaixo descreve as opções para configurar um Webhook.

1. Use o campo **Name** para criar um nome de Webhook que identificará exclusivamente o Webhook.
2. Configure o **Endpoint URI**. Esse **URI** será acessado quando o **Evento** ocorrer.
3. Você pode definir o **Webhook** como **Enabled** - **true** ou **false**. Isso permite que você suspenda temporariamente um Webhook sem removê-lo (excluí-lo) completamente do sistema.
4. Você pode definir a opção **Post multiple events in JSON array** se quiser que vários eventos sejam publicados no seu serviço em uma matriz.  Se você selecionar essa opção, seu serviço deverá ser capaz de lidar tanto com vários eventos quanto com eventos únicos.
5. Você pode adicionar até três cabeçalhos de solicitação e o valor desses cabeçalhos.  Isso permite que você publique cabeçalhos de forma segura em serviços como Hubs de Eventos do Azure, Azure Functions, Google Functions e Amazon Lambda.

<Note>
  As chaves dos cabeçalhos de solicitação podem ter até 64 caracteres e os valores podem ter até 256 caracteres para cada cabeçalho.
</Note>

1. Configure os **Filters** para processar somente os **Eventos** de que você precisa. Você pode filtrar por **Event Name**, **Event Source** e **PlayerID**.

<Note>
  Você pode ter vários **Filters** por **Group**, mas cada configuração de **Filter** deve ser atendida para que o evento se enquadre no **Filter Group**.
</Note>

1. Você pode definir vários **Filter Groups** para incluir filtros diferentes. Os **Eventos** devem se enquadrar em pelo menos *um* grupo para serem passados ao Webhook.

<img src="https://mintcdn.com/microsoft-4404708b/IwSYTY5BEqd_x-HK/images/playfab/data-analytics/acting-data/Webhook-config.png?fit=max&auto=format&n=IwSYTY5BEqd_x-HK&q=85&s=25486fe826115b4b8f42360ae4001ff0" alt="Game Manager - Dados - Webhooks - Configuração do Webhook" width="1686" height="1080" data-path="images/playfab/data-analytics/acting-data/Webhook-config.png" />


## Related topics

- [Fazer chamadas de webhook a partir do CloudScript](/pt-BR/services/playfab/live-service-management/service-gateway/automation/cloudscript/making-webhook-calls-from-cloudscript.md)
- [Recursos de eventos do PlayStream](/pt-BR/services/playfab/data-analytics/ingest-data/playstream-event-capabilities.md)
- [Início rápido do Photon](/pt-BR/services/playfab/live-service-management/service-gateway/add-ons/photon/quickstart.md)
- [Conceitos básicos da análise em tempo real](/pt-BR/services/playfab/data-analytics/ingest-data/real-time-analytics-core-concepts.md)
- [Referência do Game Manager](/pt-BR/services/playfab/live-service-management/gamemanager/reference.md)