ב־1.11 מסתיימת התמיכה בגרסה הקודמת של ה־API של Arbox, וכל החיבורים צריכים לעבור לגרסה החדשה, V3. גרסה V2 תושבת בהמשך, ולכן המעבר הוא חובה.
אם אתם עובדים עם Make, צריך להחליף בכל תרחיש (Scenario) את המודולים הישנים של Arbox במודולים של Arbox v3. במדריך הזה נעבור על ההחלפה שלב אחר שלב. אם אתם עובדים עם Zapier, אין צורך לעשות דבר. כבר עדכנו את החיבור מהצד שלנו.
מה צריך להכין
מפתח ה־API של העסק. אפשר להמשיך להשתמש באותו מפתח שכבר עובד אצלכם. את המפתח מעתיקים מהגדרות, מאזור "אינטגרציות", בשורה של "ה־API של Arbox".
רשימת התרחישים. עברו על התרחישים שלכם ב־Make וסמנו את אלה שיש בהם מודולים של Arbox.
טיפ: לפני שמתחילים, כדאי לשכפל את התרחיש (Clone) ולעבוד על העותק. כך התרחיש המקורי ממשיך לעבוד עד שהעותק מוכן ונבדק.
איך מזהים מודול ישן
למודולים הישנים יש אייקון כחול עם קו לבן אלכסוני, והם מופיעים בשם Arbox. למודולים החדשים יש אייקון כהה עגול עם הסמל של Arbox, והם מופיעים בשם Arbox v3.
כשמחפשים Arbox ב־Make, בחרו באפליקציה Arbox v3, עם רווח ועם הסימון Verified. אם מופיעה גם אפליקציה בשם Arbox-v3, עם מקף, אל תשתמשו בה.
החלפת מודול פעולה
נדגים את ההחלפה על מודול שליחת הודעה. התהליך זהה בכל מודול פעולה.
שלב 1: הוספת המודול החדש לצד הישן
פתחו את התרחיש במצב עריכה. לחצו קליק ימני על הקו שמוביל אל המודול הישן ובחרו Add module. בחלון החיפוש הקלידו Arbox v3, בחרו באפליקציה ואז במודול המקביל למודול הישן. את המודול המקביל תמצאו בטבלה שבסוף המדריך.
שלב 2: בחירת החיבור
בשדה Connection בחרו את החיבור של Arbox v3. בפעם הראשונה צריך ליצור חיבור חדש: לחצו על Add, תנו לחיבור שם והדביקו את מפתח ה־API של העסק. במודולים הבאים פשוט בחרו את אותו חיבור מהרשימה.
---------------------------------------------------------------------------
שלב 3: מילוי ומיפוי השדות
מלאו את השדות במודול החדש לפי ההגדרות של המודול הישן. לחיצה על שדה פותחת את רשימת הנתונים מהמודולים הקודמים, ומשם גוררים או בוחרים את הערך המתאים. שימו לב שחלק מהשדות שינו שם או מבנה. למשל, במודול Send a Message מזינים את מזהי הלקוחות ברשימה (User IDs). בסיום לחצו Save.
שלב 4: מחיקת המודול הישן
עכשיו המודול החדש נמצא לצד הישן. לחצו קליק ימני על המודול הישן ובחרו Delete. Make יחבר אוטומטית את המודול החדש למודול שאחריו.
---------------------------------------------------------------------------
---------------------------------------------------------------------------
חשוב: אם מודולים בהמשך התרחיש משתמשים בנתונים מהמודול הישן שמחקתם, צריך למפות אותם מחדש מהמודול החדש. מודול שחסרים לו נתונים יסומן באזהרה.
החלפת טריגר (המודול הראשון בתרחיש)
טריגר הוא המודול שמפעיל את התרחיש, למשל Watch Purchase. אי אפשר להוסיף מודול לפני הטריגר, ולכן מחליפים אותו כך:
1. הוסיפו את הטריגר החדש מ־Arbox v3, למשל Watch new purchase.
2. בטריגר מיידי (מסומן Instant) יופיע הכפתור Create a webhook. לחצו עליו, תנו ל־Webhook שם, בחרו את החיבור של Arbox v3 ולחצו Save.
3. מחקו את הטריגר הישן, וגררו קו מהטריגר החדש אל המודול הבא בתרחיש.
4. מפו מחדש את השדות במודולים שהשתמשו בנתונים מהטריגר הישן.
---------------------------------------------------------------------------
---------------------------------------------------------------------------
שמירה ובדיקה
אחרי שהחלפתם את כל המודולים של Arbox בתרחיש, לחצו Save ואז Run once כדי לוודא שהתרחיש עובד. אם הכול תקין, הפעילו את התרחיש מחדש. כדאי לבדוק בפעם הראשונה שהנתונים הגיעו ל־Arbox כמו שציפיתם.
טבלת המודולים
המודולים ב־Arbox v3 לא תמיד מקבילים אחד לאחד למודולים הישנים, ולכן ריכזנו כאן את המקבילים.
מודול ישן (Arbox) | מודול חדש (Arbox v3) | הערות |
Create a Client | Create a client |
|
Create a Lead | Create a lead |
|
Update Lead Status | Update lead status |
|
Mark Lead as Lost | Mark a lead as lost |
|
Create a Task | Create a task |
|
Search User | Get users |
|
Search Schedule | Get a schedule |
|
Book to a Trial Class | Book a trial class |
|
Cancel Trial Class Booking | Cancel a trial class booking |
|
Send a message | Send a Message | כרגע ניתן בעזרת מודול לבחור רק הודעת Push. בעזרת כתובת api אפשר גם WhatsApp |
Make an API Call | Make an API call |
|
Create a Purchase | אין מקביל ישיר | ראו בהמשך |
Watch Purchase | Watch new purchase | טריגר מיידי (Webhook) |
Watch New Client | Watch new client |
|
Watch New Lead | Watch new lead |
|
Watch Lost Lead | Watch lost leads |
|
Watch Lead Converted to Client | Watch converted lead |
|
Watch Update Lead Status | Watch updated Lead statuses |
|
Watch Trial Class | Watch trial class | טריגר מיידי (Webhook) |
Watch Appointment Booking | Watch booked appointment | טריגר מיידי (Webhook) |
Watch Appointment Update | Watch updated appointment | טריגר מיידי (Webhook) |
Watch Appointment Cancellation | Watch cancelled appointment | טריגר מיידי (Webhook) |
Watch Membership Hold | Watch membership hold | טריגר מיידי (Webhook) |
Watch Canceled Membership | Watch cancelled membership | טריגר מיידי (Webhook) |
Watch Renew Membership | Watch renew membership |
|
Watch Credit Refusal | Watch credit refusal | טריגר מיידי (Webhook) |
Watch Entry From Waiting List | Watch entry from waiting list | טריגר מיידי (Webhook) |
Watch Confirm Entry From Waiting List | Watch confirm entry from waiting list | טריגר מיידי (Webhook) |
Watch Inactive User | Watch inactive users |
|
Watch Medical Certificate/Waiver | Watch medical certificate או Watch waiver | שני מודולים נפרדים |
Watch User Cancel Registration | Watch user cancel registration |
|
ב־Arbox v3 נוספו גם מודולים חדשים, ביניהם Create a membership, Update membership, Hold membership, Cancel membership, Update user, Cancel a user booking ו־Watch signed form.
מודול שאין לו מקביל ישיר: אם התרחיש שלכם משתמש במודול כזה, אפשר לבצע את הפעולה דרך המודול Make an API call, לפי הדוקומנטציה של V3.
צריכים עזרה?
יש לכם שאלה על המעבר או רעיון לאוטומציה חדשה? הצטרפו לקהילת האוטומציות של Arbox בוואטסאפ. שם תוכלו לקבל עזרה והכוונה מהצוות שלנו ומבעלי עסקים נוספים.