GUIA DO PROGRAMADOR / WEBHOOKS DE REGISTO
01 · Evento
Um registo de hóspede é atualizado.
02 · Monday
Associe a atualização à reserva no Monday usando os IDs estáveis do registo e da reserva.
03 · Revisão
Reveja os dados dos hóspedes e trate do SIBA na EazyAL.
Os eventos webhook incluem o estado do registo e contagens, mas nunca nomes, contactos, nacionalidades ou documentos de identificação dos hóspedes.
COMEÇAR
01 · Crie uma nova chave API do Make
No Make, crie um webhook personalizado com autenticação por chave API. Gere uma chave nova (não reutilize a que recebeu por e-mail) e copie o URL e a chave. Use hook.eu1.make.com, hook.eu2.make.com, hook.us1.make.com ou hook.us2.make.com.
02 · Adicione o webhook na EazyAL
Na EazyAL, abra Casa Oakdene → Definições da propriedade → Integrações → Adicionar webhook, escolha Make e cole o URL do webhook e a nova chave API do Make.
03 · Guarde o segredo de assinatura da EazyAL
Depois de guardar, a EazyAL mostra o segredo de assinatura uma única vez. Copie-o para um gestor de segredos protegido; é diferente da chave API do Make.
04 · Envie um evento de teste
Prima Enviar evento de teste e confirme que o evento webhook.test chega ao seu cenário no Make. Configure o cenário para processar os pedidos sequencialmente.
1 / EVENTO
Campos úteis para mapear
event_id — ID estável do evento; as tentativas de reenvio reutilizam-no.
data.checkin_session_id — identificador estável do registo do hóspede.
data.external_booking_ref — ID da reserva no Monday incluído no link do hóspede.
data.status — estado atual do registo (por exemplo, ready_for_review); data.revision aumenta a cada atualização do registo.
data.guests — contagens de hóspedes previstas, com dados completos, exigidas pelo SIBA e aceites.
data.blocker_codes e sendable_now — motivo pelo qual um registo está pendente ou pronto para envio.
{
"schema_version": 1,
"event_id": "11111111-1111-4111-8111-111111111111",
"type": "registration.updated",
"occurred_at": "2026-10-02T10:00:00Z",
"data": {
"checkin_session_id": "33333333-3333-4333-8333-333333333333",
"external_booking_ref": "CO-123323211",
"revision": 3,
"status": "ready_for_review",
"guests": { "expected": 2, "completed": 2 },
"sendable_now": false,
"blocker_codes": ["stay_unlinked"]
}
}
Um evento registration.updated inclui IDs, estado, contagens e bloqueios, mas nunca nomes, contactos, nacionalidades nem dados dos documentos dos hóspedes.
2 / AUTENTICAÇÃO
Verifique a assinatura
As bibliotecas Standard Webhooks podem verificar o conteúdo bruto assinado `<webhook-id>.<webhook-timestamp>.<raw body>` usando o segredo completo `whsec_...`. Para validar manualmente com HMAC, remova o prefixo e descodifique o restante em base64.
Leia os cabeçalhos webhook-id, webhook-timestamp e webhook-signature. Rejeite carimbos de data/hora com mais de cinco minutos.
Mantenha ambas as credenciais privadas
O segredo de assinatura da EazyAL é apresentado uma única vez e é diferente da chave API do Make. Não guarde nenhuma das credenciais em colunas do Monday nem no histórico desprotegido do cenário; use um gestor de credenciais protegido ou um pequeno relay no servidor.
05 / LINK DO HÓSPEDE
URL do hóspede numa única linha
https://app.eazyal.com/guestViewPageExternal?publicToken=<the property's link token>&session=<a random ID saved on the Monday item>&guests=<party size>&external_booking_ref=<Monday booking ID>
Use o token do link de hóspedes da propriedade como valor de publicToken.
Guarde o ID de sessão gerado no item do Monday antes de enviar o link.
Reutilize o mesmo ID de sessão para todos os hóspedes da reserva. Mantenha todos os parâmetros de consulta nesta única linha do URL.
Associe os eventos de registo ao Monday
{
"data.external_booking_ref": "CO-123323211",
"data.checkin_session_id": "33333333-3333-4333-8333-333333333333",
"data.status": "ready_for_review",
}
Guarde a associação checkin_session_id → ID do item no Monday e a última revisão aplicada. Processe os pedidos sequencialmente; ignore duplicados ou revisões antigas. Encaminhe reservas sem correspondência ou com várias correspondências para um fluxo de erro.
PRIVACIDADE E FLUXO DE TRABALHO
O Monday não é o registo do hóspede
O Monday guarda os IDs da reserva e do registo para fazer a associação. A identidade e os documentos dos hóspedes só estão disponíveis na EazyAL para utilizadores com acesso à propriedade.
A revisão continua na EazyAL
O Make pode manter o Monday atualizado, mas é um anfitrião ou operador autorizado que revê os registos dos hóspedes e trata do SIBA na EazyAL.
Rode as credenciais em segurança
Se o segredo de assinatura da EazyAL for exposto, substitua-o nas definições do webhook. Para renovar a chave API do Make, elimine e recrie esse webhook com a nova chave.
ÂMBITO E ENTREGA
Quando são enviados os eventos
Os eventos são atualizados quando os hóspedes se registam, as estadias são associadas, o tamanho dos grupos é confirmado, o processo SIBA avança, os registos são cancelados ou uma chegada fica pronta para envio. Os payloads não incluem dados pessoais dos hóspedes.
Novas tentativas, duplicados e revisões
A entrega é feita pelo menos uma vez. As falhas temporárias são repetidas com intervalos progressivos durante até 24 horas; as entregas duplicadas mantêm o mesmo event_id. As revisões mais recentes substituem as atualizações antigas ainda não entregues. Guarde a última revisão aplicada por checkin_session_id.
Use event_id para eliminar duplicados, checkin_session_id como chave do registo e external_booking_ref para encontrar o item no Monday. Nunca associe registos pelo nome do hóspede ou pelas datas da estadia.