חיבור Contact Form 7 ל-Powerlink

Powerlink הינה מערכת ניהול קשרי לקוחות (CRM) מבין המובילות בארץ, ויוצא לי לראות מידי פעם שאנשים שואלים בקבוצות השונות כיצד שולחים את הלידים מטפסי צור הקשר שבאתר שלהם למערכת Powerlink. לרוב אנשים שולחים אותם ל-Zapier ומשם מקשרים ל-Powerlink, אך אני לא אוהב שחיבור בין שתי מערכות תלויות בשירות צד שלישי (שלרוב הוא בחינם), לכן אני אעדיף לכתוב קוד אשר ממשק בין השניים.

לשמחתי ל-Powerlink יש API מתקדם ונוח מאוד, במאמר זה נלמד כיצד לעבוד מול ה-API על מנת לשלוח את הלידים מטפסי Contact Form 7 ישירות אל Powerlink.

שלב ראשון – קבלת מפתח API

כאשר עובדים מול API, אחת השיטות לאימות ושיוך הקריאה לחשבון היא ע״י שימוש במפתח API. על מנת לקבל את מפתח ה-API של החשבון שלנו, נתחבר למערכת, ונלחץ בצד שמאל למעלה על גלגל השיניים (״הגדרות מערכת״) ובעמוד שיפתח, נלחץ בצד ימין על ״ממשקי אינטרנט״. בעמוד שיוצג לנו נראה שדה שנקרא ״הטוקן שלי״, נעתיק את התוכן שלו ונשמור אותו לשימוש בקוד שלנו.

שלב שני – כתיבת קוד ההתממשקות

על מנת לקבל את הנתונים שהמשתמש מילא בטופס, נשתמש ב-Hook של Contact Form 7 שנורה לאחר שהגולש שלח את הטופס והנתונים עברו ולידאציה – wpcf7_before_send_mail. נפתח את קובץ functions.php של התבנית שלנו ונדביק בסופו את הקוד הבא:

/**
 * Send form leads to powerlink.
 *
 * @param WPCF7_ContactForm $cf7 contact form 7 object.
 *
 * @return bool
 */
function dorzki_send_lead_to_powerlink( $cf7 ) {

	$submit = \WPCF7_Submission::get_instance();
	$data   = $submit->get_posted_data();

	if ( ! empty( $data ) ) {

		$api_key = 'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX';
		$api_url = 'https://api.powerlink.co.il/api/record/lead';

		$lead_data = [
			'firstname'      => $data[ 'your-name' ],
			'telephone1'     => $data[ 'your-phone' ],
			'emailaddress1'  => $data[ 'your-mail' ],
			'description'    => $data[ 'your-message' ],
			'leadsourcecode' => 4, // Internet
			'statuscode'     => 2, // First Contact
		];

		$lead_data = json_encode( $lead_data );

		$response = wp_remote_post( $api_url, [
			'headers' => [
				'Content-Type'   => 'application/json',
				'tokenid'        => $api_key,
				'Content-Length' => strlen( $lead_data ),
			],
			'body'    => $lead_data,
		] );

		return ( ! is_wp_error( $response ) );

	}

	return false;

}

add_action( 'wpcf7_before_send_mail', 'dorzki_send_lead_to_powerlink' );

בקוד הנ״ל יש להחליף את הערך של המשתנה $api_key עם המפתח API שקיבלנו בשלב הקודם, כך שבמקום הערך XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX יהיה את המפתח שקיבלנו. בחלק השני של הקוד, אנחנו שולחים את 4 השדות של הטופס שלנו (בהנחה שיש את 4 השדות הללו), שם מלא, מספר טלפון, אימייל ואת תוכן ההודעה. בנוסף, אנו מגדירים שהליד שישלח יקבל סטטוס של ״קשר ראשוני״ ושמקור הליד יהיה ״אינטרנט״.

במידה ונרצה לשלוח שדות נוספים לשדות קיימים או שדות שיצרנו במיוחד, נוכל לעשות זאת ע״י הוספת ערכים למערך $lead_data כאשר המפתח יהיה מזהה השדה ב-Powerlink, והערך יהיה שם השדה ב-Contact Form 7.

סיכום

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