Webhook integráció

1. Mikor érdemes Webhookot használni?

A Webhook segítségével olyan marketing szoftverekkel is integrálhatod az OptiMonk-ot, amelyek még nem szerepelnek az OptiMonk integrációk között. 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 (pl.: kitöltési URL, egyedi inputok értéke stb.). Mind a két esetben szükséged lesz fejlesztési kapacitásra, hogy elkészítsd azt a php-t, amely feldolgozza az OptiMonk által átadott adatokat.

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 elposztol 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])

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.
  2. Hozz létre egy új kampányt vagy válaszd ki azt a kampányt ahol használni szeretnéd a webhook integrációt, majd menj a kampány beállítások oldalra.
  3. Az oldal alján az ’Integrációk’ / ’Hová szeretnéd gyűjteni a feliratkozókat?’ résznél válaszd ki a webhook integrációt és másold be a példa php oldal URL címét a megfelelő helyre és mentsd el.

   4. 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. OptiMonk fiókodban a Kampány beállítások oldalon válaszd ki a Webhook integrációt, és kattints a következő linkre (http://hookbin.com/), melyen keresztül a hookbin.com weboldalra jutsz.

1..JPG

2. Kattints a Create New Endpoint gombra, és másold ki a Bin URL-t.

2..JPG

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 a lap tetején lévő Mentés, vagy Mentés és Módosítás gombbal.

4..JPG

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

5. 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