קטלוג השירותים

הדף הזה הוא מפת הדרכים בין שירותי Wizzo Market לבין הקוד של הליבה שמשתמש בהם. לכל שירות מופיע השם שלו ב-market_service, הנקודה בליבה שקוראת אותו, ומה קורה כשהוא לא פעיל. בהמשך מתועדים שני ה-API שמפתח אתר מפעיל בעצמו: poolse_client (דיוור) ו-spam_filter (סינון ספאם בטפסים).

הכלל המשותף: כל שירות נבדק עם market_service::is_active("<service>"), והמפתח נלקח מ-market_service::api_key("<service>"). על המנגנון עצמו ראו סקירת Wizzo Market.

השירותים ונקודות המגע בליבה#

נקודות קצה ציבוריות ושירותים#

poolse_client: דיוור מהקוד#

הקובץ: libraries/poolse_client.php. כל הקריאות הן best-effort: תקלה ב-POOLSE לא שוברת את תהליך האתר. התוצאות הן false (השירות לא נגיש או שגיאת שרת) או ["error" => ..., "http" => ...] (סירוב של השרת, קוד 4xx), ולא חריגה.

מפתח ו-URL נקבעים כך: הפרמטרים poolse_api_key ו-poolse_api_url ב-CRM_params גוברים על ההפעלה במרקט (כך אתר יכול להצביע על tenant משלו). בלי פרמטר, המפתח מגיע מהשירות wizzopoolse.

אפשרויות ל-transactional ($opts): reply_to, first_name, last_name, external_id, sender_id, vars, attachments (רשימה של filename ו-content ב-base64) ו-calendar (content ו-filename של קובץ .ics). אפשרויות ל-campaign: name, is_advertisement (ברירת מחדל true), sender_id, reply_to, preheader, created_by.

$this->load->library("poolse_client");

if (poolse_client::active())
{
    $list = poolse_client::list_id("newsletter");
    poolse_client::subscribe([
        "email"      => $email,
        "first_name" => $name,
        "list_ids"   => [$list],
    ]);

    $r = poolse_client::transactional($email, "Your code", "<p>Code: 123456</p>");
    if (isset($r["error"])) error_log("poolse refused: " . $r["error"]);
}

spam_filter: סינון ספאם בטפסים#

הקובץ: libraries/spam_filter.php. הלקוח של SpamGuard, שירות גלובלי עם מאגר מוניטין משותף (https://spamdetector.wizzo.media). המפתח נלקח מהשירות spamguard, או מ-spam_filter::$api_key אם הגדרתם אותו ידנית. הספרייה פותחת כברירת מחדל: בכל תקלת רשת, חריגת זמן (1500ms), או היעדר מפתח, התוצאה היא verdict => "allow" עם ok => false, כך שליד אמיתי לא הולך לאיבוד כשהשירות למטה.

$this->load->library("spam_filter");

$res = spam_filter::check([
    "name"    => $_POST["name"],
    "email"   => $_POST["email"],
    "phone"   => $_POST["phone"],
    "message" => $_POST["message"],
], ["js" => true]);

if ($res["verdict"] != "allow")
{
    // save the lead with an is_spam flag and skip the notification mail
}

ראו גם#

• Wizzo Market, סקירה
• מארחים חיצוניים
• מייל, שליחה דרך mail_tpl
• AI בטפסים
• בריאות וביצועים