פרמטרים מוסיפים מידע משלכם לבקשת ה-Webhook: טקסט קבוע או שדה של נמען, בכותרת הבקשה או בגוף שלה.
הוספת פרמטרים
באינטגרציות ← Webhooks, לחצו על פרמטרים ליד ה-Webhook (או בשורה של Webhook חדש, לפני שלוחצים על הוספה). ב-Webhook שמשמש באוטומציה אפשר לפתוח אותם גם מהשלב שליחת התראה: בחרו את ה-Webhook, לחצו על ערוך ואז על פרמטרים.
סוג: טקסט חופשי (ערך קבוע) או שדה של נמען (User fields).
מפתח: השם של הפרמטר.
ערך: הטקסט, או שדה הנמען.
אזור: Header או Body.
לחצו על הוספת פרמטר. הפרמטרים מופיעים תחת פרמטרים פעילים, והסרת פרמטר מוחקת פרמטר.
איך הפרמטרים נשלחים
Header: נשלח ככותרת HTTP, למשל טוקן שהשרת שלכם בודק.
Body: נוסף לאובייקט האירוע, למשל
"source": "activetrail".שדה של נמען: הערך של השדה אצל הנמען. בניסיון מופיע במקומו שם השדה.
שלח רק פרמטרים מותאמים אישית (ללא ברירות המחדל של ActiveTrail): גוף הבקשה מכיל רק את
event_typeואת הפרמטרים שלכם לגוף הבקשה, למשל{"event_type":"contact_updated","source":"activetrail"}. פרמטרים בכותרת עדיין נשלחים.
ודאו שהשרת שלכם מקבל את הכותרות והשדות הנוספים. כדי לקרוא את הפרמטרים של Webhook דרך ה-API, השתמשו ב-GET /api/webhooks/{id}/parameters (API reference: webhooks).