Share on facebook
Share on linkedin
Share on whatsapp
Share on email

חיבור טופס אלמנטור למערכת הדיוור Smoove (בלי זאפייר!)

רשימת תפוצה היא אחד הכלים הדיגיטלים החשובים ביותר לכל עסק. היא מאפשרת איסוף של מאגר לקוחות פוטנציאלים שאליהם אפשר לשלוח תוכן וגם הצעות שיווקיות. אחת הדרכים הכי נוחות לאסוף כתובות מייל לרשימת תפוצה היא באמצעות טפסים באתר האינטרנט שלנו (זה יכול להיות טופס הרשמה לתפוצה, אבל גם טופס רגיל של יצירת קשר). הטפסים של אלמנטור פרו הולכים ותופסים מקום מרכזי באתרי וורדפרס, והם כוללים אפשרויות התממשקות רבות לשירותי דיוור בינלאומיים מובילים (המפורסם שבהם הוא כמובן MailChimp המעולה). אך כאשר נרצה לחבר טופס לשירות ישראלי, מקומי, נוכל לראות שאלמנטור לא מספקים לנו פיתרון "מהקופסה", ואנו נדרשים לטיפה יותר עבודה.

viplus / Smoove היא מערכת דוברת עברית לשליחת דואר לרשימות תפוצה ושליחת מיילים שיווקיים. היא אהובה מאוד בישראל, נוחה לשימוש, ומספקת לנו אוטומציות וכלים מתקדמים מאוד.

נשאלת השאלה איך לממשק (לחבר) טופס של אלמנטור לסמוב, כך שכאשר משתמש באתר יזין את הפרטים שלו הם ייכנסו אוטומטית לרשימה בסמוב. הרבה בוני אתרים מבצעים את החיבור הזה באמצעות שירותי צד שלישי (כגון Zapier ו Integromat). כאן אני מעוניין להראות שאין שום צורך בשירות צד שלישי לצורך החיבור הזה, וניתן לעשות אותו בקלות יחסית דרך הממשק של טפסי אלמנטור פרו.

מהם היתרונות בחיבור ללא הסתמכות על גורם שלישי?

  1. אין עלויות. זה חינם.
  2. פחות גורמים מעורבים – פחות סיכוי לתקלות ושיבושים, אי זמינות של שירות וכו'.

איך נוח לך?

אני מפרט במדריך שתי שיטות – אחת קלה ולא דורשת שום ידע בקוד, ואילו השניה מיועדת למשתמשים מתקדמים יותר.

מוכנים לצאת לדרך?

שלבים 1 ו-2, אותם מבצעים במערכת Smoove, משותפים לשתי השיטות.

1.  יוצרים מפתח API בממשק של Smoove (הגדרות > מפתחות API > הוסף מפתח). מפתח הAPI הוא קוד אישי, סודי, שנוצר במיוחד עבורכם לצורך ההתממשקות.

api-key

2. בממשק של Smoove בודקים מהו המס"ד של הרשימה בה אתם מעוניינים שנרשמים ישמרו.

smoove list sku

שיטה ללא צורך בהכנסת קוד

שיטה זו היא הנוחה והמהירה ביותר. החיסרון המרכזי שלה הוא שהיא מתאימה רק בטפסים בהם אין לנו רצון להציג למשתמש תוויות מעל לשדות הטופס.

טופס עם תויות טופס בלי תויות

3. יוצרים טופס באתר שלכם באלמנטור ולשדה האימייל נותנים את התווית email.


4. אם יש בטופס שדה שם נותנים לו את התווית firstname ואם יש שדה שם משפחה נותנים לו את התווית lastname.
5. אם יש שדה טלפון נותנים לו את התווית cellphone.
6. מוסיפים לטופס שדה מוסתר (סוג > מוסתר) נותנים לו את התווית exists ובוחרים לו ערך ברירת המחדל merge.

hidden fieldmerge
7. מוסיפים לטופס שדה מוסתר (סוג > מוסתר) נותנים לו את התווית viplists ובוחרים לו ערך ברירת המחדל שהוא המס"ד של הרשימה הרצוייה בסמוב (ראו סעיף 2).

8. בפעולות אחרי שליחה מוסיפים "וובהוק"

9. בהגדרות של הוובהוק מוסיפים את הנתיב הבסיסי של התממשקות הרשמה + מפתח הAPI (שיצרתם בשלב מספר 1)

ככה הוובהוק צריך להיראות. את ה XXXX יש להחליף במפתח הAPI שלכם. יש להקפיד שלא יהיה רווח.

http://members.viplus.com/subscribe.aspx?apikey=XXXXXXXXXXXXXXXXXXXXXXXX

Webhook viplus

10. שומרים את העמוד, פותחים אותו מחוץ לאלמנטור ושולחים טופס.

11. פותחים את הרשימה הרלוונטית בSmoove. נצפה למצוא איש קשר חדש עם הפרטים שהוזנו בטופס.

שיטה שדורשת כתיבת קוד בקובץ התבנית (מחוץ לאלמנטור)

אזהרה – שיטה זו מחייבת הבנה בסיסית של קוד. ודאו שאתם מבינים מה אתם עושים, כיוון שטעויות עלולות לגרום לאתר שלכם להפסיק לעבוד.

כעת נראה דרך נוספת ליצירת ההתממשקות בין הטופס שיצרנו באלמנטור ובין מערכת Smoove. היתרון בשיטה הזאת הוא שניתן לבחור את השמות של התויות (Labels) שיוצגו למשתמשים מעל לשדות הטופס.

בשיטה הזאת אנחנו יכולים לציין איזה שם שנרצה בתוויות של השדות שלנו ("שם פרטי" "האימייל שלך" "מה הטלפון שלך?" וכו') כי את השמות שרלוונטים להתממשקות (השמות שנקבעו בAPI של Smoove) נזין לא כ"תוית" אלא כ"ID".

בשיטה הזאת לא נשתמש בWebhook דרך הממשק, אלא בקוד. כלומר, לא נבחר בפעולות אחרי שליחה > webhook.

3. יוצרים טופס באתר שלכם באלמנטור ולשדה האימייל נותנים את הID email (מתקדם > ID)


4. אם יש שדה שם, נותנים לו את הID  firstname (מתקדם > ID) ואם יש שדה שם משפחה נותנים לו את הID lastname.
5. אם יש שדה טלפון נותנים לו את הID cellphone (מתקדם > ID)
6. מוסיפים לטופס שדה מוסתר (סוג > מוסתר) נותנים לו את הID exists ובוחרים לו ערך ברירת המחדל merge.
7. מוסיפים לטופס שדה מוסתר (סוג > מוסתר) נותנים לו את הID viplists ובוחרים לו ערך ברירת המחדל שהוא המס"ד של הרשימה הרצוייה בסמוב (ראו סעיף 2).

8. שומרים את העמוד באלמנטור.
9. מדביקים ב-functions.php (בתבנית הבת כמובן. בשום אופן לא בתבנית אם) את הקוד הזה (שימו לב לסעיפים הבאים – אתם צריכים להתאים את הקוד):


add_action( 'elementor_pro/forms/new_record', function( $record, $handler ) {
//make sure its our form
$form_name = $record->get_form_settings( 'form_name' );

// Replace MY_FORM_NAME with the name you gave your form
if ( 'MY_FORM_NAME' !== $form_name ) {
return;
}

$raw_fields = $record->get( 'fields' );
$fields = [];
foreach ( $raw_fields as $id => $field ) {
$fields[ $id ] = $field['value'];
}

// Replace HTTP://YOUR_WEBHOOK_URL with the actuall URL you want to post the form to
wp_remote_post( 'http://members.viplus.com/subscribe.aspx?apikey=XXXXXXXXXXXXXXXXXXXX', [
'body' => $fields,
]);
}, 10, 2 );

10. מחליפים את XXXXXXX בAPI KEY שיוצרתם בממשק של סמוב (שלב 1).
11. מחליפים את MY_FORM_NAME בשם שהגדרתם לטופס (מעל כל השדות). אם רוצים שההתממשקות תחול על כל הטפסים באתר (בלי למקד אותה לטופס מסויים) ניתן למחוק את התנאי הזה מהקוד המקורי:


// Replace MY_FORM_NAME with the name you gave your form
if ( 'MY_FORM_NAME' !==$form_name ) {
return;
}

12. שומרים את הקובץ functions.php ומעלים לשרת.
13. פותחים את העמוד ושולחים טופס.
14. פותחים את הרשימה הרלוונטית בSmoove. נצפה למצוא איש קשר חדש עם הפרטים שהוזנו בטופס.

מה אם זה לא עובד?

  1. עיברו בסבלנות על כל התהליך שביצעתם. השמטה של פרט אחד או שלב אחד בתהליך תגרום להתממשקות להיכשל.
  2. בהתממשקות הכל צריך להיות מאוד מדוייק. רווח שאינו שייך, אות גדולה במקום אות קטנה (או להיפך) – כל אלו יגרמו להתממשקות להיכשל.
  3. בSmoove יש מסלול חינמי (עד 200 אנשי קשר). אם אתם מחברים חשבון חינמי והוא כבר מלא ב-200 אנשי קשר – ההתממשקות תיכשל.
  4. בחרתם באפשרות החיבור השנייה? (עם קוד) ודאו כי תבנית הבת שלכם תקינה ומופעלת.

לקריאה נוספת

התיעוד של טפסי אלמנטור

חיבור בין טפסי CF7 לSmoove באמצעות תוסף

שיתוף

Share on facebook
Share on whatsapp
Share on linkedin

רוצה שנחזור אליך ונקבע פגישה?

נציג "האייל" יחזור אליך בשעות הקרובות וישמח לשוחח איתך.