Webhook שולח את פרטי האירוע בחשבון אקטיב טרייל שלכם, למשל נמען שהצטרף לקבוצה או הזמנה חדשה, לכתובת URL בשרת שלכם ברגע שהאירוע קורה.

הגדרת Webhook

  1. היכנסו לאינטגרציות ← Webhooks.

  2. בחרו סוג אירוע.

  3. הזינו שם ואת כתובת ה-URL שתקבל את ה-Webhook.

  4. בחרו פורמט: JSON או FromUrlEncoded.

  5. אפשר גם ללחוץ על פרמטרים ולהוסיף כותרות או שדות משלכם (ראו פרמטרים ב-Webhooks).

  6. לחצו על ניסיון כדי לשלוח נתוני דוגמה לכתובת, ואז לחצו על הוספה.

אינטגרציות ← Webhooks: השורה של Webhook חדש (סוג אירוע, שם, URL, פורמט, פרמטרים, ניסיון, הוספה) ורשימת ה-Webhooks

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

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

השלב שליחת התראה, עם הפעלת Webhook מסומן ו-Webhook שנבחר

סוגי האירועים

סוג האירועtype בנתונים
שינוי נמעןcontact updated
שינוי ידניcontact updated
עדכון נמעןcontact updated
שלב באוטומציהautomation step
נמען הצטרף לקבוצהcontact joined a group
נמען הוסר מקבוצהcontact removed from a group
נמען הסיר את עצמוcontact unsubscribed
נמען נרשם בדף נחיתהlanding page sign-up
נמען נרשם בטופסform sign-up
נמען הצטרף לרשימת דיוורcontact joined a mailing list
נמען הוסר מרשימת דיוורcontact removed from a mailing list
הזמנה נוצרה / הזמנה עודכנהorder created / order updated
ליד נוצר / ליד עודכןlead created / lead updated
הזדמנות נוצרה / הזדמנות עודכנהopportunity created / opportunity updated
התקבלה הודעת WhatsAppwhatsapp reply
התקבלה הודעת SMS(אין)

הבקשה

  • אקטיב טרייל שולחת בקשת POST עם הכותרת User-Agent: ActiveTrail/1.3.

  • JSON: Content-Type: application/json. גוף הבקשה הוא רשימה (מערך) עם אובייקט אחד לכל אירוע.

  • FromUrlEncoded: Content-Type: application/x-www-form-urlencoded. בגוף הבקשה יש שדה אחד, data, והערך שלו הוא אובייקט האירוע כ-JSON.

  • ניסיון שולח ערכי דוגמה. בהזמנות, בלידים ובהזדמנויות, הניסיון שולח את שמות השדות עם ערכים ריקים.

אירועי נמענים

כל אירועי הנמענים שולחים את אותם שדות. דוגמה (נמען נרשם בדף נחיתה, בקיצור השדות המותאמים):

[{"type":"landing page sign-up","externalId":"LP_2d904901-b0a1-4b0d-a3cd-203c1c886055","externalName":"LP_43160","contactId":229988056,
  "contactFields":{"state":"Active","email_status_date":"2026-10-31T08:35:39","sms_state":"Active","sms_status_date":"2026-10-31T08:35:39",
  "email":"jane@example.com","sms":"","firstName":"Jane","lastName":"Doe","fax":"","zipcode":"","phone1":"","phone2":"","street":"","city":"",
  "ext1":"","ext2":"", … ,"ext25":""}}]
  • type: האירוע (ראו בטבלה).

  • externalId, externalName: המזהה החיצוני והשם החיצוני של הנמען. בהרשמה מדף נחיתה: LP_<number> ו-LP_<page ID>.

  • contactId: המזהה של הנמען באקטיב טרייל.

  • contactFields: ‏state ו-sms_state הם סטטוס המייל וסטטוס ה-SMS, למשל Active, ‏DoNotMail (לא אישר דיוור) או Unsubscribed; ‏email_status_date ו-sms_status_date הם המועד שבו כל סטטוס נקבע. אחריהם שדות הנמען (מייל, SMS, שם, כתובת, טלפונים) והשדות המותאמים ext1 עד ext25.

שלב באוטומציה

אותם שדות כמו באירועי נמענים, ובנוסף automationId, ‏automationName ו-lastStepResults (תיאור של השלב האחרון של הנמען).

הזמנות, לידים והזדמנויות

דוגמה (הזמנה נוצרה):

[{"type":"order created","orderId":"1002","orderName":"Order 1002","externalId":"cust-1","externalName":"my-store",
  "firstName":"Jane","lastName":"Doe","email":"jane@example.com","mobile":null,"netAmount":100.0,"tax":17.0,"coupon":"SAVE10",
  "quantity":1,"totalAmount":117.0,"address":"1 Main Street","city":"Tel Aviv",
  "products":[{"id":"MUG-01","name":"Mug","quantity":1,"unitprice":100.0,"totalprice":100.0,"category":"Home","brand":"Demo", …}],
  "purchaseDate":"2026-10-31T06:15:39.00Z","lastUpdate":"2026-10-31T06:15:40.59Z","purchaseType":"Online","status":"Completed",
  "storeId":0,"locationType":"Unknown","ext1":null, … ,"num1":null, … ,"date1":null, …}]

לידים והזדמנויות שולחים את אותם שדות, עם leadId/leadName או opportunityId/opportunityName במקום המזהה והשם של ההזמנה, ועם expectedPurchaseDate במקום purchaseDate. השדות זהים לשדות ב-API של מסחר ושל מחזור המכירה.

תשובות ב-WhatsApp וב-SMS

  • התקבלה הודעת WhatsApp: ‏type, ‏campaignId, ‏crmUserId (המזהה של הנמען), ‏mobile, ‏firstName, ‏lastName, ‏email, ‏reply ו-date.

  • התקבלה הודעת SMS: ‏campaignId, ‏crmUserId, ‏mobile, ‏reply, ‏date ו-customUserField.