Webhook שולח את פרטי האירוע בחשבון אקטיב טרייל שלכם, למשל נמען שהצטרף לקבוצה או הזמנה חדשה, לכתובת URL בשרת שלכם ברגע שהאירוע קורה.
הגדרת Webhook
היכנסו לאינטגרציות ← Webhooks.
בחרו סוג אירוע.
הזינו שם ואת כתובת ה-URL שתקבל את ה-Webhook.
בחרו פורמט: JSON או FromUrlEncoded.
אפשר גם ללחוץ על פרמטרים ולהוסיף כותרות או שדות משלכם (ראו פרמטרים ב-Webhooks).
לחצו על ניסיון כדי לשלוח נתוני דוגמה לכתובת, ואז לחצו על הוספה.
ה-Webhooks שלכם מופיעים תחת ה-Webhooks שלכם, לפי סוג האירוע. המתג מפעיל או מכבה Webhook, ניסיון שולח נתוני דוגמה, ומחק מוחק אותו.
Webhooks מאוטומציה: Webhooks מסוג שלב באוטומציה נשלחים מהשלב שליחת התראה באוטומציה. סמנו את הפעלת 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 |
| התקבלה הודעת WhatsApp | whatsapp 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.