# Crie sua primeira URL de webhook

> Alguns passos simples para criar webhooks no Pocket Alert

*25.01.2025*

<!-- source: https://pocketalert.app/pt/blog/create-your-first-webhook-url -->

[//]: # '# Como integrar webhooks do Bitbucket ao pocket alert'

## Criar um novo webhook

![criar webhook](https://cdn.pocketalert.app/guides/git/webhook-create.gif)

1. Acesse a página de [Webhooks](https://pocketalert.app/webhooks)
2. Clique no botão "Criar"
3. Preencha o formulário com as seguintes informações:
   - **Nome**: O nome do webhook
   - **Aplicativo**: O aplicativo ao qual o webhook será vinculado
   - **Dispositivo**: O dispositivo ao qual o webhook será vinculado
   - **Mensagem**: A mensagem a ser enviada quando o webhook for acionado
4. Clique no botão "Criar"
5. Copie a URL do webhook

**Na mensagem, especificamos \* para obter todo o JSON e definir quais parâmetros precisamos.**

## Como funciona o analisador de JSON
Webhooks são essenciais para a transmissão de dados em tempo real entre aplicativos. Siga estes passos para configurar webhooks de forma eficiente e garantir uma integração perfeita com seus sistemas.

1. **Defina a estrutura do seu payload JSON**
   Identifique o formato dos dados que você deseja receber. Para capturar o conjunto completo de dados, use o símbolo curinga * na sua configuração. Isso garante que todo o payload JSON seja entregue sem filtragem.
2. **Extraia dados específicos de JSON aninhado**
   Para acessar campos individuais dentro de objetos aninhados, use a sintaxe `%objectName.field%`. Por exemplo, `%params.name%` extrai o valor de name do objeto params.

```json
{
  "event": {
    "title": "New Order",
    "message": "A new order has been placed with ID 12345",
    "tags": ["order", "new"],
    "users": [
      {"first": "Dale", "last": "Murphy", "age": 44, "nets": ["ig", "fb", "tw"]},
      {"first": "Roger", "last": "Craig", "age": 68, "nets": ["fb", "tw"]},
      {"first": "Jane", "last": "Murphy", "age": 47, "nets": ["ig", "tw"]}
    ]
  }
}
```

Para configurar o webhook, você faria assim:

- Se quiser exibir o JSON inteiro, basta usar o *
- Para obter o título do evento, use `%event.title%`
- Para obter a mensagem, use `%event.message%`
- Para obter as tags, use `%event.tags%`

```json
Title: %event.title%
Message: %event.message%
Tags: %event.tags%
Users: %event.users.0%
First user: %event.users.0.first% %event.users.0.last%
```

Veja abaixo um exemplo de como ficaria a saída usando a configuração acima com base no JSON de exemplo:

```
Title: New Order
Message: A new order has been placed with ID 12345
Tags: ["order","new"]
Users: {"age":44,"first":"Dale","last":"Murphy","nets":["ig","fb","tw"]}
First user: Dale Murphy
```

Mais informações sobre as variáveis podem ser encontradas na [sintaxe GJSON Path](https://github.com/tidwall/gjson/blob/master/SYNTAX.md).
