זאפייר

ביצוע פעולות עם webhooks ללא שימוש באפליקציית mybusiness

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

פעולות אלו קורות דרך תהליך הנקרא webhook. בכדי להגדיר webhook לפעולה מסויימת עקבו אחר השלבים הבאים:

1. יש ליצור חשבון באתר Zapier ולפתוח זאפ חדש.
2. השלב הראשון של הזאפ- עדכון הטריגר, הינו באחריות בלעדית של הלקוח. שימו לב הטריגר יכול להיות כל דבר שמתממשק עם זאפייר, ביצוע פעולה ברשתות חברתיות, קבלת מייל עם נושא מסויים לתיבת הדואר אשר תוסיף רשומה בטבלה מסוימת ועוד.
3. לאחר ביצוע טריגר מסויים אנו נבחר בפעולה מסוג webhook:

●        אנו נבחר בסוג פעולה מסוג PUT  על מנת לעדכן אובייקט קיים.

●        POST  יוסיף לנו רשומה חדשה לטבלה.

●        GET ישלוף מידע עבורנו מאובייקט מסויים.

●        DELETE ימחוק עבורנו אובייקט מסויים

יש בתהליך זה מספר שדות חובה שיש למלא בכדי שהפעולה תעבוד. ההבדל בין PUT לבין Post אשר מוסיף רשומה חדשה הינו הסימון של הID של הרשומה שנראה בהמשך.

●        Web2Lead- הכנסת לידים למערכת ווידוא כפילות. במידה והליד כפול- יעדכן את הסטטוס כליד כפול, במידה והליד לא מזוהה יעדכן סטטוס ליד חדש. החיפוש מתבצע לפי מייל/טלפון.

                        URL לטובת Web2Lead הוא – https://api.mbapps.co.il/functions/AppId/getlead את פרטי הAPPId ניתן למצוא בסביבת פיתוח- תחת הגדרות Databases

●        Web2sale – הכנסת לידים + הקמת מכירה לכל ליד ווידוא כפילויות. במידה והליד חדש, יוקם ליד + מכירה, במידה והליד מזוהה כקיים תוקם מכירה בלבד על הליד/ לקוח הנוכחי.

URL לטובת Web2Sale הוא – https://api.mbapps.co.il/functions/AppId/web-to-sale

●        ייבוא כללי – ייבוא נתונים לכל טבלה קיימת במערכת. גם לעדכון, חיפוש ומחיקה. הURL בנוי מהצורה הבאה: https://api.mbapps.co.il/parse/classes/ObjectId/TableName

*יש לשנות את הTableName לפי הטבלה אליה אתם רוצים לגשת, והOBJECTID במקרה וזה PUT ,DELETE או GET.

*בכל הדוגמאות הנתונים בשדות הינם דוגמה בלבד, יש לשים את הנתונים המתקבלים בשלבים הקודמים.

**בשדות שהינם שדות פוינטר יש להזין את ה-ObjectId של הערך הרלוונטי.

●        בייבוא באופן של Web2Lead- יש להזין את ה-JSON בצורה הבאה:

{

        “PhoneNumber”: "0500000000",

        “Email”: "test@test",

        “Name”: "j",

        “Campaign”: "camp1",

        “Comment”: "comment",

        “C_LeadSource”: "id of the value",

        "City":"tel aviv",

        "Address": "haagana"

    }

●        בייבוא באופן של Web2Sale- יש להזין את ה-JSON בצורה הבאה:

{

      “phone”: "0543543",

      “email”: "test@email.com",

      “account_Name”: "שם לבדיקה",

      “account_City”: "עיר",

      “sale_Name”:"הזדמנות מכירה",

      “sale_Source” :"קמפיין בדיקה"   ,

      “sale_SaleStatusId”: "E9cYlAlooc"

    }

●        בייבוא כללי – יש להזין את ה-JSON בצורה הבאה:

 *שימו לב שהדוגמא הבאה מכילה שדות מספריים, פוינטר וטקסט:

{

  "Name": "כותרת מזאפ",

  "Total": 900,

  "SaleStatusId": {

 "__type": "Pointer",

 "className": "SaleStatuses",

  "objectId": "zrP1MSVBoq"

  }

}

שימו לב לצורה בה הפוינטר רשום (מתחיל מ"SaleStatusId"), הערך הראשון(_type) הינו קבוע, בערך השני יש להכניס את השם הטבלה במקום SaleStatuses וכמובן את האובייקט שאנו רוצים לקחת מטבלה זו בתור הערך השלישי.

יש לשים לב לרגישות הJSON, שדה מספרי ללא מקף, פסיקים במקומות הנכונים וכ'ו. הזאפ לא ייתן לנו אינדיקציה היכן השגיאה לכן יש להפקיד לבדוק את הקוד בקפידה.

7. את החלק התחתון של הHeaders יש למלא בתצורה הבאה:

*השורה השלישית רלוונטית רק לייבוא כללי.

X-Parse-Application-Id       YourAppID

Content-Type                   application/json

X-Parse-Master-Key          YourMasterKey

יש לוודא שמספר האפליקציה ומספר המפתח במקומות הנכונים.

את פרטי MasterKey ניתן לקבל מצוות התמיכה. 

8. נאשר ונבצע בדיקה, נוכל לראות את השינוי המיידי בעת הבדיקה:

9. תצוגה לאחר ביצוע הזאפ:

שימו לב שבדוגמא זו הערכים הינם קבועים, ניתן דרך הזאפ בקלות להגדיר ערך מסויים בID או בJSON שיהיה דינאמי ויגיע משלב קודם בתהליך, לדוגמא משלב חיפוש, או מהטריגר: