Napojenie na CRM (Make, Zapier, webhook)

Kontakty zo súťaží a pripomienky klientov hneď vo Vašich systémoch.

Napojenie nastavíte v Nastaveniach organizácie › Integrácie. Pri každom novom kontakte (a voliteľne pripomienke klienta) pošleme údaje vo formáte JSON na adresu, ktorú zadáte. Je v balíkoch Pro, Agentúra a Enterprise a v skúšobnom období.

Make

  1. Nový scenár › modul Webhooks › Custom webhook › Add › skopírujte adresu.
  2. V štúdiu pridajte napojenie s touto adresou a kliknite Poslať skúšobný kontakt; Make podľa neho spozná štruktúru údajov.
  3. Pridajte ďalší modul, napríklad HubSpot, Pipedrive, Google Sheets alebo Mailchimp, a namapujte polia.

Zapier

  1. Nový Zap › spúšťač Webhooks by Zapier › Catch Hook › skopírujte adresu.
  2. V štúdiu pridajte napojenie a pošlite skúšobný kontakt, v Zapieri kliknite Test trigger.
  3. Pridajte akciu do Vášho CRM.

Formát údajov

{
  "id": "6f1c…",
  "event": "lead.created",
  "created_at": "2026-10-29T10:15:00.000Z",
  "data": {
    "project": { "id": "…", "slug": "sutaz-kavovar", "name": "Súťaž o kávovar" },
    "contact": {
      "id": "…",
      "name": "Eva Nováková",
      "email": "[email protected]",
      "phone": null,
      "locale": "sk",
      "detail": "win",
      "consent_text": "Súhlasím so spracúvaním údajov na účel súťaže.",
      "created_at": "2026-10-29T10:15:00.000Z"
    }
  }
}

Hlavičky: X-Dimenzum-Event (lead.created, review.created alebo test), X-Dimenzum-Delivery (identifikátor doručenia, rovnaký pri opakovaní) a X-Dimenzum-Signature s podpisom.

Overenie podpisu (vlastný server)

Podpis je HMAC SHA-256 z textu „čas.telo“ s kľúčom, ktorý vidíte pri napojení. Overte ho a odmietnite správy staršie ako 5 minút.

// Node.js: overenie podpisu webhooku Dimenzum
import { createHmac, timingSafeEqual } from 'node:crypto';

function verify(body, header, secret) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  const expected = createHmac('sha256', secret).update(`${parts.t}.${body}`).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) < 300;
  return fresh && timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
}
<?php // PHP: overenie podpisu webhooku Dimenzum
$body = file_get_contents('php://input');
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_DIMENZUM_SIGNATURE'] ?? ''), $sig);
$expected = hash_hmac('sha256', $sig['t'] . '.' . $body, getenv('DIMENZUM_SECRET'));
if (!hash_equals($expected, $sig['v1'] ?? '') || abs(time() - (int) $sig['t']) > 300) {
  http_response_code(400);
  exit;
}
$event = json_decode($body, true);

Chyby a opakovanie

Ak Váš server neodpovie kódom 2xx do 10 sekúnd, skúsime to znova po 1, 5 a 30 minútach, po 2 a 12 hodinách. Po 20 neúspechoch za sebou sa napojenie pozastaví; zapnete ho jedným klikom. Stav posledných odoslaní vidíte pri napojení.

Adresa musí byť https a viesť na verejný server. Po doručení obsah z našej fronty mažeme, nedoručený najneskôr po 14 dňoch.