12 ביולי 2023

ממשק API לטופס של האבספוט

אחת הדרכים לקישור והזרמת דאטא אל האבספוט היא דרך API.

API - הזרמת לידים ישירה אל מערכת האבספוט שלכם (דרך כתיבת קוד מסויים שמעביר את הלידים אל האבספוט, מאחוררי הקלעים).

***

אליה וקוץ בה... 

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

הדרך המומלצת היא לקשר ב- API אל האבספוט, אבל דרך טופס מתווך.

קישור API של טופס אל האבספוט

***

לאחר שיחת ייעוץ עם לקוחה, המלצתי לה כעת לעבור ל- API שמזרים את הדאטא לטופס (ולא ישירות לדאטאבייס).

היתרון: אפשר יהיה בקלות לזהות את הלידים הנכנסים (כי יקוטלגו תחת טופס).

לא יהיה צריך לבצע "חפירות ארכיאולוגיות" בדאטא, גם במצבים של פניות כפולות\ ריבוי פניות.

***

לינק לדף של האבספוט להסבר על ה- API הזה - קליק כאן

***

הסבר מפורט על תהליך יצירת הטופס + הכנת ה- API (המפתח) + שליחת החומרים למתכנת.


שלב 1: יצירת טופס בהאבספוט שקולט את הדאטא

השלב  הראשון הוא יצירת טופס בהאבספוט שקולט את הדאטא

יצירת הטופס - כרגיל דרך כפתור ה- MARKETING

יש לוודא שאתם מושכים לטופס את הפרופרטיס המדוייקים לצורך

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


מספר ה- ID של הטופס (לינק A)

לכל טופס יש ID, את ה- ID ואת הלינק לטופס יש לשלוח למתכנת

איך מעתיקים את ה- ID של הטופס?


דוגמא ללינק לטופס (לינק B)

כדי להעתיק את הלינק לטופס, יש להכנס למודול הטפסים, לעמוד עם הסמן על השורה המתאימה + קליק על ACTIONS + קליק על VIEW


לינק לדוגמא לטופס:

https://share.hsforms.com/1uUjYc_ZyRJG_t4I9qF ry1g2xjmr


שלב 2: יצירת ה- API

בניית ה- API דרך ה- SETTINGS בהאבספוט ואז PRIVATE APPS.


ואז סימון הצ'קבוקסים הנכונים להזרמת הדאטא לטפסים דרך ה- API: 


לאחר שמירה, תוכלו להעתיק את הקוד ל- API (לינק C).
נקרא גם ACCES TOKEN


שלב 3: שליחה למתכנת (מודגשים בורוד בהסבר עצמו שלהלן)

לאחר הסיום יש לשלוח במייל למתכנת:

א. את ה- ID של הטופס (לינק A) 
ב. את הלינק לטופס (לינק B)
ג. את הקוד ל- API (לינק C) - מה שנקרא ACCESS TOKEN

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

***

להטמעת האבספוט גם אצלכם: "מד-מן" 052-7325777

מילות מפתח: האבספוט, טופס, טפסים, API לטופס, API לטפסים, ממשק לטופס