טפסי Elementor ל-CRM ישראלי: webhook, לידים כפולים ומספרי טלפון

ל-Elementor Pro אין פעולה מובנית למערכות CRM ישראליות כמו Fireberry, monday.com או ActiveTrail. מחברים אותן דרך פעולת ה-Webhook ב-Actions After Submit של הטופס, שמופנית לכלי אוטומציה או לנקודת קצה משלכם, או דרך ה-hook של PHP בשם elementor_pro/forms/new_record, שנותן מזהי שדות, כותרות וטיפול בשגיאות.

ווידג'ט הטפסים של Elementor Pro נמצא בחלק גדול מאתרי הוורדפרס בישראל, והשאלה שחוזרת היא תמיד אותה שאלה: איך כל ליד מגיע ל-CRM פעם אחת בדיוק, עם מספר טלפון תקין ועם הקמפיין שממנו הגיע. כאן תמצאו את האפשרויות, מה כל אחת שולחת בפועל, ואיפה לידים הולכים לאיבוד.

מה Elementor יכול לשלוח אחרי שליחת טופס?

Elementor מריץ את הפעולות שמופיעות בשדה Actions After Submit, בלשונית Content של ווידג'ט הטופס, וטופס אחד יכול להריץ כמה מהן. מהקופסה הווידג'ט מציע:

• Collect Submissions - שומר כל פנייה ב-WP-Admin תחת Elementor > Submissions. הפעולה פעילה כברירת מחדל.
• Email ו-Email 2 - בדרך כלל התראה אליכם ואישור לגולש.
• Redirect ו-Popup - מה שהגולש רואה אחר כך.
• Webhook - שולח את הפנייה לכל כתובת.
• שירותי שיווק - MailChimp, Drip, ActiveCampaign, GetResponse, ConvertKit ו-MailerLite, וגם Slack ו-Discord.

אף מערכת ישראלית לא מופיעה ברשימה. ל-Fireberry (לשעבר Powerlink), ל-monday.com, ל-ActiveTrail ולרב מסר מגיעים דרך פעולת ה-Webhook, דרך תוסף צד שלישי או דרך קוד. Elementor מאפשר למפתחים חיצוניים לרשום פעולות טופס חדשות, וכך תוספים כאלה עובדים, ולכן כדאי לבדוק מי מתחזק תוסף כזה לפני שצינור המכירות שלכם תלוי בו. לצד רשימות הדיוור, המדריך ל-API של ActiveTrail מסביר על טוקנים שפגים ועל נעילת IP.

מה פעולת ה-Webhook של Elementor שולחת בפועל?

פעולת ה-Webhook של Elementor שולחת בקשת POST לכתובת שהדבקתם, ויש לה הגדרה נוספת אחת: מתג Advanced Data. אין בה מקום לכותרת הרשאה, אין מיפוי שדות ואין דרך לשנות את שמות המפתחות. בקשת פיצ'ר ב-דיוני GitHub של Elementor (מספר 21768, מרץ 2023) מבקשת בדיוק את זה, ומשתמשים שם מדווחים שהשדות מגיעים לפי התוויות שלהם ולא לפי המזהים. מכאן שלוש השלכות:

• תווית היא לא מפתח יציב. שיניתם בעורך את "טלפון" ל"טלפון נייד", והצד המקבל מפסיק למצוא את השדה בלי שום הודעה. בטופס בעברית המפתח הוא תווית בעברית, והקוד המקבל צריך להתאים לה בדיוק.
• אי אפשר לפנות ישירות ל-CRM שדורש טוקן. Fireberry מאמתת כל בקשה בכותרת tokenid, ו-monday.com מצפה לכותרת Authorization. פעולת ה-Webhook לא שולחת אף אחת מהן, ולכן היא צריכה להצביע על משהו באמצע - Zapier, Make, n8n או נקודת קצה משלכם - שמוסיף את פרטי הגישה.
• קראו את גוף הבקשה, אל תנחשו אותו. דפי העזרה של Elementor לא מתעדים את הגוף המדויק עם Advanced Data ובלעדיו. הפנו את ה-webhook לכתובת שמציגה בקשות נכנסות, שלחו ליד בדיקה בכל אחת מההגדרות, ומפו לפי מה שהגיע בפועל.

כשהקוד של הוורדפרס בשליטתכם, הדרך הנקייה יותר היא ה-hook בשם elementor_pro/forms/new_record, שרץ אחרי פעולות הטופס. הדוגמה של Elementor עצמה קוראת את $record->get( 'fields' ), שממופה לפי המזהה של כל שדה, ושולחת עם wp_remote_post. תנו לכל שדה מזהה משלו (phone, email, utm_source), והמיפוי ישרוד כל שינוי בתוויות שהגולש רואה:

add_action( 'elementor_pro/forms/new_record', function ( $record, $handler ) {
    if ( 'lead_form' !== $record->get_form_settings( 'form_name' ) ) {
        return;
    }
    $fields = [];
    foreach ( $record->get( 'fields' ) as $id => $field ) {
        $fields[ $id ] = $field['value'];
    }
    $response = wp_remote_post( 'https://api.fireberry.com/api/record/{object}', [
        'headers' => [ 'tokenid' => FIREBERRY_TOKEN, 'Content-Type' => 'application/json' ],
        'body'    => wp_json_encode( map_to_crm_fields( $fields ) ),
        'timeout' => 15,
    ] );
    if ( is_wp_error( $response ) || wp_remote_retrieve_response_code( $response ) >= 300 ) {
        error_log( 'CRM push failed: ' . $record->get_form_settings( 'form_name' ) );
    }
}, 10, 2 );

את {object} ואת map_to_crm_fields() אתם ממלאים, כי שמות האובייקטים והשדות משתנים מחשבון Fireberry אחד לאחר - המדריך ל-API של Fireberry מסביר איך מגלים אותם. הטוקן של Fireberry גם נושא את ההרשאות של המשתמש שהוא שייך לו, ולכן הנפיקו אותו ממשתמש אינטגרציה ייעודי ולא מהחשבון של איש מכירות.

ארבע דרכים להכניס לידים מ-Elementor ל-CRM ישראלי

מה קורה כשה-webhook של Elementor נכשל?

כשהכתובת המקבלת לא זמינה או מחזירה שגיאה, הליד לא מגיע ל-CRM, והתיעוד של Elementor לא מתאר תור ניסיונות חוזרים לפעולת ה-Webhook. הגולש עדיין רואה את הודעת ההצלחה, כך שאיש לא שם לב עד שאיש מכירות שואל לאן נעלמו הלידים. ארבעה הרגלים סוגרים את הפער:

1. השאירו את Collect Submissions פעיל. כל פנייה נשמרת ב-Elementor > Submissions, ו-Export All to CSV או Export Selected to CSV נותנים לכם רשימה להשוואה מול ה-CRM.
2. קראו את התגובה. ה-hook בשם elementor_pro/forms/webhooks/response מקבל את התגובה של wp_remote_post, מערך או WP_Error, יחד עם הרשומה. תעדו שם כישלונות, או העבירו אותם לתור שמנסה שוב.
3. כבדו את המגבלות של ה-CRM. Fireberry מאפשרת כברירת מחדל 100 בקשות לדקה לכל ארגון, שנספרות על פני כל הטוקנים והאינטגרציות יחד, ומעבר לזה מחזירה 429 Too Many Requests. יש גם מגבלה יומית שמתאפסת ב-00:00 UTC.
4. השוו בקביעות. פעם בשבוע השוו את מספר הפניות בוורדפרס למספר הלידים שנפתחו ב-CRM ממקור האתר.

לידים כפולים ומספרי טלפון ישראליים

לידים כפולים מ-Elementor נוצרים כשאותו אדם ממלא שני טפסים, שולח שוב יום אחרי, או כשניסיון חוזר אחרי timeout יוצא לדרך למרות שהבקשה הראשונה בעצם הצליחה. ה-CRM לא יזהה את האדם אם האינטגרציה לא בודקת לפני שהיא יוצרת, והבדיקה עובדת רק על מספר טלפון מנורמל:

• פורמט טלפון אחד. אותו מספר נייד מגיע כ-052-1234567, כ-0521234567, כ-+972 52-123-4567 או כ-972521234567. הסירו כל מה שאינו ספרה, המירו 972 בתחילת המספר ל-0 (או להפך), ושמרו צורה אחת בלבד. לא משנה מה הטופס מקבל, עשו את זה בשרת.
• קודם חיפוש, אחר כך יצירה. חפשו קודם לפי הטלפון המנורמל ולפי האימייל באותיות קטנות. ב-Fireberry קריאה היא בקשת POST אל /api/query; ב-monday.com חפשו בלוח לפני שקוראים ל-create_item, כפי שהמדריך ל-API של monday.com מתאר.
• עדכון כשנמצאה התאמה. צרפו את הפנייה החדשה לליד הקיים כהערה או כפעילות, במקום לפתוח ליד שני.
• שימו לב לתוויות סטטוס ב-monday.com. create_item מקבל את column_values כמחרוזת JSON, והארגומנט create_labels_if_missing ייצור תווית סטטוס חדשה משגיאת כתיב אם תאפשרו לו.

איך שומרים את מקור ה-UTM ואת ההסכמה בטופס Elementor?

ערכי UTM מגיעים ל-CRM דרך שדה Hidden שערך ברירת המחדל שלו הוא התגית הדינמית Request Parameter של Elementor. בלשונית Advanced של השדה לחצו על אייקון התוכן הדינמי, בחרו Site > Request Parameter, קבעו את הסוג ל-Get ואת שם הפרמטר ל-utm_source, והוסיפו Fallback כמו direct. חזרו על זה עבור utm_medium, utm_campaign ו-gclid. שלושה דברים לבדוק:

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

החלק הזה הוא תיאור טכני, לא ייעוץ משפטי. להסכמה לדיוור יש ב-Elementor שדה מסוג Acceptance. שלחו את הערך שלו ל-CRM כשדה נפרד, יחד עם זמן השליחה והנוסח המדויק שהגולש ראה, כך שהרשומה תראה על מה הסכימו ומתי. כדאי להוסיף גם את סוגי השדות Honeypot ו-reCAPTCHA, כי כל ספאם שמגיע ל-CRM עולה לאיש מכירות שיחה מיותרת.

מקורות

• Elementor - פעולות אחרי שליחת טופס (Actions After Submit)
• Elementor Developers - ה-hooks של הטפסים: new_record ו-webhooks/response
• Fireberry API - מגבלות קצב