Um **Webhook** permite que a mymento envie notificações automáticas para o seu sistema em tempo real por meio de requisições HTTP POST. Com ele, você recebe avisos instantâneos sobre eventos importantes — como novas vendas ou atualizações de status — eliminando a necessidade de consultar a API da mymento constantemente (polling).

### Como Funciona

1. **Destino:** Você configura uma URL HTTPS segura do seu servidor.

2. **Disparo:** Sempre que o evento configurado ocorrer (ex: criação ou alteração de uma reserva), a mymento dispara uma requisição POST para a sua URL.

3. **Payload:** O corpo da requisição contém um objeto JSON detalhado com o tipo da ação (`create` ou `update`) e os dados completos da venda.

4. **Segurança (Opcional):** Você pode definir um token de validação. Ele será enviado no cabeçalho `X-Webhook-Token` da requisição, permitindo que seu servidor verifique a autenticidade da origem.

5. **Timeout:** O tempo máximo que o seu servidor tem para responder à requisição é de **15 segundos**.

**⚠️ Requisito Prévio:** O uso de Webhooks requer que o **módulo de API** esteja devidamente contratado e ativo em sua conta mymento.

### Passo a Passo para Configuração

1. Acesse o painel administrativo em [**Configurações**](https://admin.mymento.com.br/account/connections)[ > ](https://admin.mymento.com.br/account/connections)[**Conexões**](https://admin.mymento.com.br/account/connections)[ > ](https://admin.mymento.com.br/account/connections)[**Webhook**](https://admin.mymento.com.br/account/connections)[ > ](https://admin.mymento.com.br/account/connections)[**Configurar**](https://admin.mymento.com.br/account/connections).

2. No campo correspondente, insira a **URL HTTPS** do seu sistema que receberá os dados.

3. Selecione quais **tipos de evento** (gatilhos) sua aplicação deseja escutar.

4. *(Opcional)* Defina uma chave secreta no campo **Token de Validação** para aumentar a segurança do seu endpoint.

### Estrutura do JSON Enviado (Payload)

Abaixo, veja um exemplo prático do objeto JSON enviado pela mymento em uma ação de atualização (`update`):

![](https://app.chatwoot.com/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsibWVzc2FnZSI6IkJBaHBCQitDWlFVPSIsImV4cCI6bnVsbCwicHVyIjoiYmxvYl9pZCJ9fQ==--5499d05e3f580a416ec58688d8ea054fd095c255/ray-so-export%20(2).png)