Envía las solicitudes de la web a tu CRM, Zapier o Make

Cada solicitud enviada desde tu web puede llegar también a una dirección tuya como un POST en JSON firmado: un webhook.

Configúralo

La solicitud se sigue guardando en Keyio y enviando a tu email como siempre; el webhook es una copia más para tu sistema.

  1. 1En tu herramienta, crea un disparador de webhook (en Zapier, «Webhooks by Zapier › Catch Hook»; en Make, «Custom webhook») y copia su dirección.
  2. 2En Web › Medición › «Enviar las solicitudes a tu sistema», pégala y publica. La dirección tiene que ser https, en el puerto normal y de un servidor público.
  3. 3Al publicar, Keyio crea el secreto de firma y lo enseña bajo la dirección.
  4. 4Pulsa Enviar una prueba: llega una solicitud inventada con "test": true, y el editor te dice qué ha respondido tu sistema.

Qué llega

Un POST con un cuerpo JSON: "event": "website.request", el id y la fecha de la solicitud, la web (slug y dominio) y la propia solicitud: nombre, email, teléfono, mensaje, vivienda, fechas de llegada y salida, personas, importe calculado e idioma del visitante.

Keyio lo intenta una vez y espera hasta 3 segundos una respuesta (cualquier 2xx cuenta como recibida). No sigue redirecciones. Si tu sistema está caído, la solicitud no se pierde: está en Keyio y en tu email.

Comprueba que viene de Keyio

Cada envío lleva la cabecera X-Keyio-Signature: t=<segundos unix>,v1=<firma>. La firma es el HMAC-SHA256, en hexadecimal, del texto "<t>.<cuerpo tal cual>" con tu secreto. Calcúlala con el cuerpo exactamente como llega, compárala con v1 y rechaza marcas de tiempo antiguas (por ejemplo, de más de cinco minutos) para que no se pueda repetir un envío copiado.

Zapier y Make aceptan la solicitud sin comprobar la firma; compruébala si la recibe tu propio servidor.