למה לשלב External HTTP APIs עם ChatBot IL
אינטגרציית External HTTP API של ChatBot IL מאפשרת לכם לחבר את תהליכי העבודה של הצ'אטבוט שלכם ליישומי צד שלישי, וכך לאפשר אוטומציה חלקה והחלפת נתונים יעילה. יכולת זו משדרגת את פונקציונליות הצ'אטבוט בכך שהיא מאפשרת לו לתקשר עם שירותים חיצוניים, למשוך או לשלוח נתונים, ולהפעיל פעולות בזמן אמת.
יתרונות מרכזיים
אוטומציה של תהליכי עבודה: הפחיתו תהליכים ידניים באמצעות אינטגרציה עם מערכות CRM, פלטפורמות מסחר אלקטרוני ושירותים נוספים.
החלפת נתונים חלקה: שלחו וקבלו נתונים באופן דינמי בין הצ'אטבוט שלכם לבין מערכות חיצוניות.
שיפור מעורבות המשתמשים: התאימו תגובות אישית וספקו מידע בזמן אמת ממקורות צד שלישי.
תמיכה בתפעול העסקי: בצעו אוטומציה לעיבוד הזמנות, רישום משתמשים ושליפת נתונים, ליצירת חוויית שימוש יעילה וחלקה יותר.
סיכום
אינטגרציית External HTTP API של ChatBot IL מעניקה לעסקים את היכולת לחבר את הצ'אטבוט שלהם לשירותים חיצוניים, להפוך תהליכים לאוטומטיים ולשפר את האינטראקציה עם הלקוחות. התחילו לשלב כבר היום כדי למצות את מלוא הפוטנציאל של אוטומציית המעורבות ב-WhatsApp!
להלן מדריך שלב אחר שלב להגדרה ואינטגרציה של HTTP API.
שלב 1: גישה לאזור HTTP API
בלוח הבקרה של ChatBot IL, נווטו אל אזור "WhatsApp HTTP API" דרך
Integration -> HTTP API.
כאן תוכלו לצפות בחיבורי ה-API הקיימים שלכם ולהוסיף חיבורים חדשים.
לחצו על כפתור "Create" כדי להתחיל בהגדרת חיבור API חדש.
שלב 2: הוספת פרטי חיבור ה-API
בחלק זה תגדירו את הגדרות ה-API לצורך חיבור לשירותים חיצוניים:
API Name: הזינו שם ברור וקל לזיהוי עבור חיבור ה-API שלכם (לדוגמה: "WordPress User Create").
Method: בחרו את שיטת ה-HTTP המתאימה (לדוגמה: POST, GET) בהתאם לדרישות של ה-API החיצוני.
Endpoint URL: הזינו את כתובת ה-URL המלאה של ה-API החיצוני שאליו תרצו להתחבר (לדוגמה: https://example.com/api/v1/users/create).
Test Subscriber ID: הזינו מזהה מנוי (Subscriber ID) על ידי העתקתו מתוך Subscriber Manager. השתמשו ב-Subscriber ID של מספר הטלפון שלכם. מזהה זה משמש בפועל לקריאה ל-API במהלך תהליך האימות. במקרים מסוימים ייתכן שיידרשו נתונים דינמיים לצורך העברת מידע משדות מותאמים אישית או משדות מערכת. לכן, לצורך הבדיקה הראשונית, פשוט הזינו מזהה Subscriber לבדיקה.
שלב 3: הגדרת כותרות הבקשה (Request Headers)
בחלק זה עליכם להגדיר את כותרות ה-HTTP הנדרשות לצורך ביצוע בקשת ה-API:
Content-Type: הגדירו ערך זה כ-application/json או כסוג תוכן אחר, בהתאם למפרט ה-API.
Authorization: אם ה-API דורש אימות/הרשאה (לדוגמה: Basic Auth, Bearer Token), הוסיפו את הכותרת המתאימה עם הטוקן או פרטי ההזדהות הנדרשים.
דוגמה:
Authorization: Bearer
שלב 4: הגדרת גוף הבקשה (אופציונלי)
אם בקשת ה-API דורשת שליחת נתונים בגוף הבקשה (בדרך כלל בבקשות POST או PUT), יש להגדיר כאן את השדות הרלוונטיים:
Body Data Fields: הוסיפו את השדות הנדרשים עבור בקשת ה-API.
לדוגמה, בצילום המסך גוף הבקשה כולל נתוני משתמש כגון: username, first_name, last_name ו-email.
ניתן להגדיר עבור כל שדה האם הוא יהיה ערך סטטי (ערך קבוע) או ערך דינמי (נשלף מקלט משתמש או ממידע חיצוני).
ניתן גם לבחור בין הפורמטים form-data, x-www-form-urlencoded ו-raw, בהתאם לדרישות ה-API.
שלב 5: שמירה ואימות החיבור
לאחר שהזנתם את כל השדות הנדרשים:
לחצו על הכפתור "Verify Connection". המערכת תשלח בקשת בדיקה ל-API החיצוני כדי לוודא שהכול מוגדר כראוי.
לאחר שהאימות הושלם בהצלחה, לחצו על "Save API" כדי לשמור את החיבור באופן סופי.
שלב 6: מיפוי נתוני תגובת ה-API
לאחר יצירת חיבור API בהצלחה, תוכלו למפות את נתוני התגובה חזרה לתוך תהליך העבודה שלכם:
HTTP API Response Mapping: אזור זה מאפשר לכם למפות שדות מתוך תגובת ה-API אל נתוני המנוי (Subscriber) או אל משתנים אחרים בתוך ChatBot IL.
לדוגמה, אם ה-API מחזיר ערכים כמו user_id או email, ניתן למפות אותם חזרה לפרופיל המנוי בתוך המערכת.
ניתן גם לשמור List Items. הם יישמרו בפורמט JSON, וניתן יהיה להשתמש בערך הזה ליצירת רשימה דינמית עבור Interactive Message בתוך תהליך ה-WhatsApp Bot Flow.
שלב 7: שימוש ב-Flow Builder
לאחר שה-API שלכם מחובר ומיפוי התגובה הוגדר, תוכלו להשתמש כעת בחיבור ה-API הזה בתוך Flow Builder כדי להפעיל קריאות API בנקודות שונות במהלך זרימת השיחה של הצ'אטבוט.
HTTP API Element: בתוך Flow Builder, ניתן להוסיף את רכיב HTTP API בכל מקום שתרצו.
הגדירו מתי וכיצד יש לבצע את קריאת ה-API בהתאם לאינטראקציות של המשתמש.
סיכום
באמצעות ההגדרה הזו, תוכלו לשלב באופן מלא ממשקי API חיצוניים בתוך תהליכי העבודה של ChatBot IL, ולאפשר פעולות כגון יצירת משתמשים, שליפת נתוני מנויים או עדכון מערכות חיצוניות ישירות מתוך זרימות הצ'אטבוט של ChatBot IL.
לתיעוד מפורט יותר על כל שלב בהגדרת חיבור ה-API או על הגדרות מתקדמות, אתם מוזמנים לפנות לצוות התמיכה שלנו.
