שליחת פניות ב-API למערכת חיצונית במערכת FIX Marketing של פיקס דיגיטל

 

במדריך הזה נראה איך שולחים קריאות API, ממערכת FIX Marketing למערכת חיצונית.

חלק א: הגדרת האוטומציה

1. ניהול מערכת

יש ללחוץ על "ניהול מערכת".

ניהול מערכת

2. אוטומציות שיווק

בתפריט, יש לבחור "אוטומציות שיווק".

אוטומציות שיווק

3. אוטומציה חדשה

יש ללחוץ על "אוטומציה חדשה".

אוטומציה חדשה

4. HTTP request

תחת "שליחת נתונים למערכות חיצוניות", יש לבחור "HTTP request".

HTTP request

5. שם האוטומציה

יש לתת לאוטומציה שם, ולוודא שהמתג "פעיל" דלוק.

שם האוטומציה

6. הגדרות אוטומציה

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

הגדרות אוטומציה

7. בחירת מקור אחד

במסך הזה, כל התנאים חייבים להתקיים יחד. לכן מומלץ לבחור סוג מקור אחד, למשל נכס דיגיטלי, ובשאר השדות לבחור "הכל".

בחירת מקור אחד

8. הגדרות נוספות

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

הגדרות נוספות

9. URL

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

URL

10. סוג

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

סוג

11. POST Data

בשדה POST Data, כותבים את הפרטים שיישלחו, למשל שם וטלפון: שם השדה, סימן שווה, והערך. דוגמה מלאה מופיעה בחלונית Tooltip, כשמעבירים את העכבר על סימן המידע שליד השדה.

POST Data

12. שדות דינמיים

ברשימה "שדות דינמיים", בוחרים פרט מהפנייה, כמו טלפון, והמערכת מוסיפה אותו לשדה POST Data.

שדות דינמיים

13. Headers

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

Headers

14. Content Type

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

Content Type

15. סיום ושמירה

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

סיום ושמירה

חלק ב: בדיקת השליחה בלוג

16. לוג האוטומציה

כדי לבדוק שהשליחה מתבצעת, ב"ניהול מערכת" > "אוטומציות שיווק", יש ללחוץ על שלוש הנקודות בשורת האוטומציה, ולבחור "לוג".

לוג האוטומציה

17. היסטוריית אוטומציה

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

היסטוריית אוטומציה

18. תחילת טיפול בפנייה

השורה Start handler, עם מספר הליד, אומרת שהאוטומציה התחילה לטפל בפנייה.

תחילת טיפול בפנייה

19. הפנייה נשלחה

מעליה, השורה שמתחילה במילה HttpRequest מראה שהפנייה נשלחה: לאיזו כתובת, ואילו פרטים.

הפנייה נשלחה

20. תשובת המערכת החיצונית

בסוף השורה, Response is OK אומר שהמערכת החיצונית קיבלה את הפנייה. אם מופיעה כאן שגיאה, יש לבדוק את ההגדרות מול הספק של המערכת החיצונית.

תשובת המערכת החיצונית

21. קישורים

קישורים