פרמטרים מוסיפים מידע משלכם לבקשת ה-Webhook: טקסט קבוע או שדה של נמען, בכותרת הבקשה או בגוף שלה.

הוספת פרמטרים

  1. באינטגרציות ← Webhooks, לחצו על פרמטרים ליד ה-Webhook (או בשורה של Webhook חדש, לפני שלוחצים על הוספה). ב-Webhook שמשמש באוטומציה אפשר לפתוח אותם גם מהשלב שליחת התראה: בחרו את ה-Webhook, לחצו על ערוך ואז על פרמטרים.

  2. סוג: טקסט חופשי (ערך קבוע) או שדה של נמען (User fields).

  3. מפתח: השם של הפרמטר.

  4. ערך: הטקסט, או שדה הנמען.

  5. אזור: Header או Body.

  6. לחצו על הוספת פרמטר. הפרמטרים מופיעים תחת פרמטרים פעילים, והסרת פרמטר מוחקת פרמטר.

החלון פרמטרים: פרמטר בכותרת X-Api-Token ופרמטר בגוף הבקשה source = activetrail תחת פרמטרים פעילים

איך הפרמטרים נשלחים

  • Header: נשלח ככותרת HTTP, למשל טוקן שהשרת שלכם בודק.

  • Body: נוסף לאובייקט האירוע, למשל "source": "activetrail".

  • שדה של נמען: הערך של השדה אצל הנמען. בניסיון מופיע במקומו שם השדה.

  • שלח רק פרמטרים מותאמים אישית (ללא ברירות המחדל של ActiveTrail): גוף הבקשה מכיל רק את event_type ואת הפרמטרים שלכם לגוף הבקשה, למשל {"event_type":"contact_updated","source":"activetrail"}. פרמטרים בכותרת עדיין נשלחים.

ודאו שהשרת שלכם מקבל את הכותרות והשדות הנוספים. כדי לקרוא את הפרמטרים של Webhook דרך ה-API, השתמשו ב-GET /api/webhooks/{id}/parameters (API reference: webhooks).