תבניות Webhook
תבניות Webhook הן בקשות Webhook לשימוש חוזר - URL, מתודה, כותרות, אימות וגוף, נשמרים פעם אחת ומשמשים בכל קמפיין Webhook או צעד במסע. דוגמה טיפוסית היא "שליחת MMS דרך Delivyr": כל מסע שזקוק לה משתמש באותה בקשה במקום להקליד אותה מחדש. הן נמצאות תחת Brand Studio → Webhook Templates (/brand/webhook-templates). צפייה בספרייה דורשת templates:read; יצירה ועריכה דורשות templates:write.
מה מכילה תבנית Webhook
הבקשה המלאה שצעד ה-Webhook שולח: ה-URL, מתודת ה-HTTP, כותרות מותאמות, אימות (ללא, Bearer token, Basic, כותרת API key, או חתימת HMAC), והגוף - JSON עם מצייני מקום של Liquid כמו {{user.phone}}, או שדות בקידוד טופס. הבונה הוא אותו טופס כמו צעד ה-Webhook בקמפיין, כולל שליחת בדיקה מול איש קשר לדוגמה. הבדיקה משתמשת באיש הקשר שבחרתם - איש קשר אמיתי מוצג בדיוק כפי ששליחה חיה הייתה מציגה אותו - ואת התוצאה אפשר להחליף בין התגובה שהתקבלה להבקשה שנשלחה: המתודה, ה-URL, הכותרות והגוף המדויקים שנשלחו, כשפרטי ההזדהות מוסתרים.
סודות
טוקנים, סיסמאות, מפתחות API וסודות חתימה מוצפנים כשהתבנית נשמרת ולעולם אינם מוצגים שוב: סוד שמור מופיע כשדה מוסתר. השאירו את השדה המוסתר כפי שהוא כדי לשמור את הסוד, נקו אותו כדי להסיר אותו, או הקלידו ערך חדש כדי להחליף. שליחת בדיקה לעולם אינה משדרת ערך מוסתר; הזינו את הסוד מחדש אם תרצו לבדוק אותו.
כשקמפיין או מסע נבנים מתבנית, Joryio מעתיקה את הסוד השמור של התבנית לעותק בצד השרת, כך שההודעה נושאת את פרטי הגישה בלי שהסוד יעבור אי פעם דרך הדפדפן שלכם.
שימוש בתבנית
- קמפיינים - בשלב כתיבת ה-Webhook, הודעה חדשה נפתחת עם שני אריחים: בניית הבקשה או שימוש בתבנית Webhook. בחרו תבנית לפי שם (העדכניות קודם) והיא מועתקת להודעה.
- מסעות - לצומת הודעת Webhook, ולבלוק ה-Webhook העצמאי, יש חיפוש התחלה מתבנית בראש לשונית הבקשה.
הקמפיין או המסע הם הבעלים של העותק. עריכתו, או עריכת התבנית מאוחר יותר, לעולם אינה משפיעה על השני. מחיקת תבנית בטוחה: עותקים קיימים ממשיכים לעבוד.
ניהול תבניות
הספרייה מציגה כל תבנית עם המתודה וה-URL שלה, מי יצר ומי ערך אותה לאחרונה, ומתי. השורות מציעות עריכה, שכפול ומחיקה; בחירת שורות פותחת מחיקה מרובה. החיפוש תואם שם, תיאור ו-URL; מסנן התגיות מצמצם לפי תגית.