Zum Hauptinhalt springen

Generic Webhook

The webhook adapter is a fallback for CRM systems that don't have a dedicated Atrium adapter. Instead of calling a specific CRM API, Atrium sends visitor events as HTTP POST requests to a URL you configure.

When to use webhooks​

  • Your CRM isn't one of the natively supported systems (Salesforce, HubSpot, Dynamics 365).
  • You want to integrate with an internal system, data warehouse, or custom application.
  • You need to trigger a workflow in a third-party automation tool (Zapier, Make, n8n, Power Automate).

What the webhook sends​

Atrium sends an HTTP POST request for each event, with a JSON payload:

Visitor pre-registered:

{
  "event": "visitor.pre_registered",
  "timestamp": "2026-04-15T09:30:00Z",
  "visitor": {
    "email": "jane.smith@example.com",
    "first_name": "Jane",
    "last_name": "Smith",
    "company": "Acme Corp"
  },
  "visit": {
    "host": "John Doe",
    "site": "Munich HQ",
    "expected_arrival": "2026-04-15T10:00:00Z",
    "purpose": "Project kickoff"
  }
}

Visitor checked out:

{
  "event": "visitor.checked_out",
  "timestamp": "2026-04-15T14:30:00Z",
  "visitor": { ... },
  "visit": {
    "checked_in_at": "2026-04-15T10:05:00Z",
    "checked_out_at": "2026-04-15T14:30:00Z",
    "documents_signed": ["NDA v3", "WiFi Policy v1"]
  }
}

Setup​

  1. Navigate to Settings → Integrations → CRM.
  2. Select Webhook.
  3. Enter the Webhook URL — the endpoint that will receive the POST requests.
  4. Optionally configure an HMAC secret — Atrium signs each request with this secret so you can verify authenticity.
  5. Select which events to send (pre-registration, check-in, check-out, or all).
  6. Test the webhook with a sample payload.

Reliability​

Webhook delivery uses the same retry logic as other CRM adapters:

  • If the endpoint returns a non-2xx status code or times out, the delivery is retried.
  • Retries use exponential backoff (5 seconds, then increasing up to 5 minutes).
  • After 10 failed attempts, the event is moved to a dead-letter queue for manual inspection.

Limitations​

  • No contact lookup: The webhook adapter is one-directional (Atrium → your system). It doesn't support looking up contacts during pre-registration. For contact lookup, you need a dedicated CRM adapter or a custom integration via the Atrium API.
  • No automatic retry configuration: The retry policy is fixed (10 attempts with exponential backoff). Custom retry policies are not configurable.