Webhook integráció

1. Mikor érdemes Webhookot használni?

A Webhook kiváló eszköz, ha olyan rendszerrel szeretnénk integrálni az OptiMonkot, amivel még nincs direkt integrációnk. Továbbá akkor is hasznos eszköz, ha ugyan létezik hozzá integráció az OptiMonk-ban, de olyan adatokat is szeretnél átadni, amit az alap OptiMonk integráció nem tud. Mind a két esetben szükséged lesz fejlesztési kapacitásra ahhoz, hogy elkészítsd azt a kódot, amely feldolgozza az OptiMonk által átadott adatokat. Ha nincs fejlesztőd, akkor érdemes lehet elgondolkozni a Zapier használatán, ami szintén össze tudja kötni az OptiMonkot más rendszerekkel, és a beállítása nem igényel fejlesztői tudást.

2. Hogyan működik a Webhookos adatátadás?

Amennyiben be van állítva a Webhook integráció, akkor kampány kitöltésekor az OptiMonk elküld bizonyos adatokat az integrációnál megadott php oldalnak. Alapértelmezetten a következő adatok kerülnek továbbításra:

  • Keresztnév (változó: firstname)
  • Vezetéknév (változó: lastname)
  • Email cím (változó: email)
  • URL cím (változó: url)
  • Kampány név (változó: campaign[name])
  • Kampány ID (változó: campaign[id])
  • Kuponkód (változó: custom_fields[coupon_code], amennyiben a sablon "Lumira/Vegas")
  • GDPR checkbox érték (változó: custom_fields[om_policy_checkbox])

checkbox.png

checkboxom.png

dropdown.png

dropdownom.png

email.png

emailom.png

fname.png

fnameom.png

lname.png

lastnameom.png

phone.png

phoneom.png

radio.png

radiom.png

webhookadatok.png

webhookadatok1.png

https://webhook.site/

Webhook-nál nem szükséges semmiféle plusz jelölés, ezáltal úgy a legegyszerűbb, ha azt a nevet adjuk meg az input fielden OptiMonkon belül, ami a tárgy neve.

3. Példa php oldal.

A következő példa, egy olyan minta kód, amely a Webhooktól megkapott adatokat elküldi emailben a feliratkozáskor megadott email címre, vagy egy előre definiált email címre.

A példa oldal php forráskódja:

<?php
echo "OptiMonk Webhook Test";
$emailAddress = "";

$webhookContent = "";
// get webhook data
$webhook = fopen('php://input', 'rb');
while (!feof($webhook)) {
    $webhookContent .= fread($webhook, 4096);
}
fclose($webhook);

// convert webhook data to Subscriber array
$rawData = explode("&", urldecode($webhookContent));
foreach ($rawData as $field) {
    $temp = explode("=", $field);
    $subscriber[$temp[0]] = $temp[1];
}

// set subject and recipient
if ( $emailAddress != "") {
    $to = $emailAddress;
    $subject = "New Subscriber!";
} else {
    $to = $subscriber["email"];
    $subject = "[OptiMonk Webhook test] Thank you for subscribing!";
}

$body = "Subscriber data: \n\r";

// write subscriber data in email body
foreach ($subscriber as $key => $value) {
    $body .= $key . ": " . $value . "\n";
}

// send mail
mail($to, $subject, $body);
die;
?>

 

A példa php oldal URL-címe:   https://www.optimonk.hu/webhook_sample.php

4. Tesztelés lépésről lépésre.

OptiMonk php oldalon keresztül:

  1. Jelentkezz be az OptiMonk fiókodba a https://app.optimonk.com/login/hu oldalon

  2. Hozz létre egy új kampányt vagy válaszd ki bal oldalon a Kampányok menüt, és azon belül azt a Kampányt, ahol szeretnéd beállítani a Webhook integrációt:

    mceclip1.png

  3. A jobb oldalon válaszd a Beállítások módosítása lehetőséget:

    mceclip2.png

  4. Válaszd ki az Új integráció beállítása lehetőséget az Integrációk alatt:

    mceclip3.png

  5. Válasszuk ki a Webhookot a listáról:

    mceclip4.png

  6. Illesszük be a PHP oldalnak az URLjét és adjunk egy nevet az integrációnak:

    mceclip0.png
    A beállítások mentéséhez kattintsunk a Kész majd jobb fent a Tovább gombra.

  7. Ezután amikor megjelent a popup, az általad kitöltött email címre fogja küldeni a webhook az adatokat.

HookBin oldalon keresztül:

  1. Példánkban a hookbin.com weboldalt használjuk. Nyissuk meg a linket: http://hookbin.com/ és kattints a Create New Endpoint gombra:

    mceclip5.png

  2. Ez után másold ki a Bin URL-t:

    mceclip6.png

  3. A HookBin oldalát hagyd nyitva. Illeszd be az URL-t az OptiMonk admin oldalán az URL mezőbe, majd mentsd el a kampány beállításait Kész majd jobb fent a Tovább gombra kattintva.

    mceclip7.png

  4. Végül töltsd ki a kampányhoz tartozó popupot a saját weboldaladon, és frissítsd a HookBin oldalát.
    Ha minden rendben ment, akkor a következőhöz hasonló adatokat kell látnod:

    3..JPG

    A Body részben láthatod az OptiMonktól fogadott adatokat.
Van még kérdése? Kérelem beküldése

Megjegyzések

Üzemelteti a Zendesk