הגדרת וובהוק למופע בגרין
שלב ההגדרה
- היכנסו למופע הרלוונטי בחשבון GREEN-API שלכם.
- לחצו על שנה הגדרות בחלק העליון.
- עברו לחלק של הוובהוק, והגדירו את כתובת הוובהוק שלכם.
- בחרו את סוגי האירועים שעליהם תרצו לקבל נוטיפיקציה.
⚠️ חשוב: השאירו את שדה ה-Header ריק, אלא אם המערכת שאיתה אתם עובדים מחייבת אחרת.
סוגי וובהוקים
| סוג | תיאור | הערות |
|---|---|---|
| הודעות נכנסות | כל הודעה שמגיעה למספרכם | |
| הודעות יוצאות מהמכשיר | הודעות שנשלחות דרך הטלפון | |
| הודעות יוצאות מה-API | הודעות שנשלחות דרך ה-API של גרין | |
| הודעות שנמחקו | הודעות נכנסות או יוצאות שנמחקו | נדרש להגדיר בנוסף קבלת הודעות נכנסות או יוצאות |
| הודעות שנערכו | הודעות נכנסות או יוצאות שנערכו | נדרש להגדיר בנוסף קבלת הודעות נכנסות או יוצאות |
| סטטוס מסירה | עדכון על שליחה/קריאה/מסירה על הודעות שנשלחו | נדרש להגדיר בנוסף קבלת הודעות יוצאות |
| שינוי סטטוס חשבון | המופע התנתק, התחבר, נכנס לסטטוס מתחיל, כרטיס צהוב או חסימה של החשבון | נכון לעכשיו, החסימות הזמניות לא מופיעות |
| חסימת צ'אט | כשמישהו חוסם אתכם | |
| סקרים | תגובות לסקרים שנשלחו | כדי לקבל וובהוק על תשובות לסקר ששלחתם, תצטרכו להגדיר קבלת וובהוק על הודעות נכנסות. אם מדובר בסקר שנשלח מהפלאפון ולא דרך ה-API, תצטרכו להגדיר בנוסף וובהוק על הודעות יוצאות |
| שיחות קוליות נכנסות | בעת שיחת ווצאפ נכנסת | עדכון על שיחה נכנסת, מענה או חוסר מענה ובדחייה |
| שיחות קוליות יוצאות | בעת שיחת ווצאפ יוצאת | עדכון על תחילת השיחה (לפחות משתמש אחד ענה לשיחה, חוסר מענה או כישלון |
הערות כלליות
שינוי סטטוס חשבון - מופעים עשויים לעבור מצב Starting לזמן קצר; תקבלו וובהוק גם על זה וברוב המקרים אין לכם סיבה להתייחס אליו והמופע יחזור למצב מחובר מעצמו. במקרה וזה לא קורה - יש לפנות לתמיכה.
שיחות קוליות - מגיע יותר מוובהוק אחד לכל שיחה, ניתן לראות את הסוגים ותהליכי השיחה השונים לשיחות נכנסות כאן ולשיחות יוצאות כאן.
צורות שונות לקבלת המידע - גרין שולחים את הוובהוקים על הודעות טקסט נכנסות בשני מבנים, זה נובע בגלל זיהוי פלטפורמה שונה שאמורה להכיל מידע נוסף (למשל ליד מפייסבוק שמגיע עם מידע נוסף). בפועל זה קורה הרבה ולא רק במקרים כמו לידים, וצריך להכיר ולעבוד עם שני הסוגים. מצורפות תמונות מתוך Make:
לשם הנוחות, מצרף את המבנה כאן כדי לעבוד עם המשתנים של ההודעה ב-Make:
{{1.messageData.extendedTextMessageData.text}}{{1.messageData.textMessageData.textMessage}}
פשוט שימו אותם יחד ללא רווח או ירידת שורה, והמודול או הפילטרים יתייחסו להודעה באיזו מהצורות שהיא תגיע.
שמירת וובהוקים - במידה והשרת שלכם לא זמין ולא מחזיר לגרין חיווי תקין (200), גרין ישמרו את הוובהוק וינסו לשלוח אותו עד 24 שעות מרגע האירוע. לאחר מכן הוובהוק יימחק.
זמינות השרת שלכם - גרין מנסים לשלוח את הוובהוק מיידית בעת האירוע. במידה והשרת שלכם לא היה זמין, גרין ינסו לשלוח שוב פעם בדקה. לכן הקפידו שהשרת שלכם זמין ומוכן לקבל את הוובהוק. מומלץ בעבודה עם Make או n8n לוודא שהסנריו או הוורקפלואו פעילים, וב-n8n לוודא ששמים וובהוק פרודקשן ולא טסט.
וובהוק אחד בלבד - ניתן להגדיר רק כתובת וובהוק אחת שגרין ישלחו אליה את המידע.
המלצות
- פילטור דרך מייק — במודול באפליקציה שלי למייק ניתן לבצע מספר פילטורים שלא תחוייבו עליהם בקרדיטים: סינון לקבלת וובהוקים רק מקבוצות או רק מאנשי הקשר, והאם לקבל וובהוק על תגובות אימוג'י על הודעות (Reactions). במודול שהמפתח של גרין בנה ניתן להגדיר לקבל וובהוקים מצ'אטים ספציפיים שתרצו בלבד.
- פילטור מתקדם דרך Google scripts - ניתן לשלוח את כל הוובהוקים מגרין לגוגל סקריפט. להרחבה ממליץ לצפות בוובינר שהעברתי בנושא:
שאלות? צרו קשר ב-WhatsApp.
תגובות
עדיין אין תגובות. היו הראשונים!
רוצים להגיב?