Webhooks

Webhooks são uma forma de receber e reagir a eventos em tempo real da Wink e TripPay relacionados com a sua conta.

Exemplo

1. Uma reserva ocorre na Wink.
2. O evento da Wink booking.created é disparado.
3. O seu sistema está a ouvir ativamente este evento.
4. O seu sistema regista o seu próprio conjunto de análises e usa este evento para atualizar a sua base de dados de séries temporais.

Exemplo de entrada de webhook

Nota

Um webhook da Wink é diferente de um webhook da TripPay.

• Se quiser ouvir eventos da Wink, pode criar um webhook a partir do Extranet ou do Studio.
• Se quiser ouvir eventos da TripPay, pode criar um webhook a partir do Payment.

Para este exemplo, iremos autenticar via Studio.

1. Depois de autenticado, clique no ícone do seu perfil, no canto superior direito, e aparecerá um menu.
2. Clique no link Webhooks.
3. Será redirecionado para a sua página de webhooks.

Criar webhook

Cuidado

É necessário criar uma conta de afiliado na Wink ou uma conta na TripPay antes de criar um webhook, pois irá associar o seu webhook a uma conta específica.

Aqui estão os passos para criar um webhook:

1. Na página de webhooks, clique no botão Create new webhook.
2. Nome Dê um nome ao seu webhook. ex. Wink Stalker
3. Ativar Deixe como está para estar ativado.
4. Nome da entidade Associe o seu webhook a uma das suas contas existentes. ex. Cool Account
5. Eventos Ouça os eventos que lhe interessam. ex. booking.created
6. URL do webhook Introduza a URL onde irá ouvir os eventos da nossa parte. ex. https://my.system.com/webhook/wink
7. Clique no botão Save para continuar.

Será redirecionado de volta para a sua lista de webhooks e o seu novo webhook estará pronto a usar.

Atualizar webhook

Será necessário atualizar a sua app se quiser:

• Desativar o seu webhook.
• Ouvir mais / menos eventos.
• Alterar a URL do webhook onde ouve os eventos.

Para atualizar um webhook existente, faça o seguinte:

1. Clique no link Actions do webhook que pretende atualizar.
2. Clique no botão Update em Actions.
3. Faça as alterações ao webhook.
4. Clique no botão Save para continuar.

Será redirecionado de volta para a sua lista de webhooks.

Remover webhook

Se não precisar mais do webhook, pode removê-lo.

Para remover um webhook, faça o seguinte:

1. Clique no link Actions do webhook que pretende remover.
2. Clique no botão Remove em Actions.
3. Clique no botão OK para confirmar a eliminação.

Será redirecionado de volta para a sua lista de webhooks.