1. סקירה כללית

Leads & Conversations API מאפשר למערכות חיצוניות, בוטים, WhatsApp, טפסים, Make.com ומערכות CRM ליצור לידים, לעדכן מידע ולשמור שיחות בתוך חשבון הלקוח ב־1net.me.

ה־API מזהה את החשבון לפי מפתח API, מאתר את הלקוח לפי טלפון או אימייל בתוך קבוצת הלידים, ולאחר מכן יוצר או מעדכן את הרשומה.

2. כתובת ה־API

מומלץ לשלוח בקשות POST בפורמט JSON, עם מפתח ה־API בכותרת HTTP.

3. אימות והרשאות

מומלץ להעביר את מפתח ה־API בכותרת X-1netme-ApiKey.

POST https://api.1net.me/api/leads.aspx
Content-Type: application/json
X-1netme-ApiKey: YOUR_API_KEY

לצורך תאימות לאחור ניתן להעביר גם את הפרמטר ApiCode ב־POST או ב־Query String.

4. פורמטים נתמכים

ה־API קורא ערכים לפי סדר העדיפות הבא:

לשימוש חדש מומלץ לעבוד עם POST ו־JSON.

5. מצבי עבודה, mode

6. יצירה או עדכון ליד ושיחה

יש לשלוח mode=saveconversation. בכל קריאה ה־API מבצע את השלבים הבאים:

{
  "mode": "saveconversation",
  "saveType": "custom_and_activity",
  "firstName": "ישראל",
  "lastName": "ישראלי",
  "mobile": "0501234567",
  "GroupID": "123",
  "platform": "WhatsApp",
  "custom1": "WhatsApp",
  "custom2": "Clinikit+",
  "mediaType": "1",
  "direction": "incoming",
  "message": "שלום, אני רוצה מידע על המערכת",
  "conversationTimeoutMinutes": "60"
}

7. פרמטרים של saveconversation

8. ערכי saveType

9. דוגמאות שימוש

8.1 יצירת ליד בלבד

{
  "mode": "saveconversation",
  "saveType": "lead",
  "firstName": "ישראל",
  "lastName": "ישראלי",
  "mobile": "0501234567",
  "GroupID": "123",
  "platform": "WhatsApp"
}

8.2 עדכון Custom1 עד Custom8

{
  "mode": "saveconversation",
  "saveType": "custom",
  "mobile": "0501234567",
  "GroupID": "123",
  "custom1": "WhatsApp",
  "custom2": "Clinikit+",
  "custom3": "מבקש הדגמה",
  "custom4": "ליד חם",
  "custom5": "מאמן כושר",
  "custom6": "תל אביב",
  "custom7": "3 עובדים",
  "custom8": "לחזור מחר"
}

8.3 שמירת הודעה בשיחה

{
  "mode": "saveconversation",
  "saveType": "activity",
  "firstName": "ישראל",
  "mobile": "0501234567",
  "GroupID": "123",
  "platform": "WhatsApp",
  "mediaType": "1",
  "direction": "incoming",
  "message": "שלום, אני רוצה מידע על המערכת",
  "conversationTimeoutMinutes": "60",
  "userID": "0",
  "followUpBy": "0"
}

8.4 הודעת המשך של הנציג

{
  "mode": "saveconversation",
  "saveType": "activity",
  "mobile": "0501234567",
  "GroupID": "123",
  "platform": "WhatsApp",
  "mediaType": "1",
  "direction": "outgoing",
  "message": "בשמחה, אשלח לך קישור להדגמה",
  "conversationTimeoutMinutes": "60"
}

10. כיצד נשמרת שיחה מצטברת

ה־API מחפש פעילות קיימת לפי SiteID, SubscriberID, mediaType, isActive וחלון הזמן שנשלח.

[28/07/2026 23:20] לקוח:
שלום, אני רוצה מידע על המערכת

[28/07/2026 23:22] נציג:
בשמחה, באיזה שירות אתה מתעניין?

[28/07/2026 23:24] לקוח:
אני מעוניין בעיקר בניהול תורים

11. מבנה תשובות

תגובה תקינה של saveconversation:

{
  "status": "OK",
  "subscriberID": 4521,
  "activityID": 981,
  "isNewSubscriber": false,
  "isNewConversation": false,
  "categoryID": 123
}

12. קודי שגיאה

13. קבלת רשימת לידים, mode=list

GET https://api.1net.me/api/leads.aspx?mode=list&GroupID=123&ft=json&mr=100&dateModify=2026-07-01
X-1netme-ApiKey: YOUR_API_KEY

14. דוגמאות cURL ו־JavaScript

cURL

curl -X POST "https://api.1net.me/api/leads.aspx" \
  -H "Content-Type: application/json" \
  -H "X-1netme-ApiKey: YOUR_API_KEY" \
  -d '{
    "mode": "saveconversation",
    "saveType": "activity",
    "mobile": "0501234567",
    "GroupID": "123",
    "platform": "WhatsApp",
    "mediaType": "1",
    "direction": "incoming",
    "message": "שלום, אני רוצה מידע"
  }'

JavaScript, קריאה מצד שרת בלבד

fetch("https://api.1net.me/api/leads.aspx", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-1netme-ApiKey": "YOUR_API_KEY"
  },
  body: JSON.stringify({
    mode: "saveconversation",
    saveType: "custom_and_activity",
    firstName: "ישראל",
    mobile: "0501234567",
    GroupID: "123",
    platform: "WhatsApp",
    custom1: "WhatsApp",
    mediaType: "1",
    direction: "incoming",
    message: "אני רוצה מידע על המערכת",
    conversationTimeoutMinutes: "60"
  })
})
.then(response => response.json())
.then(data => console.log(data));

15. דגשים למטמיע

• שלחו תמיד אותו GroupID עבור אותה אינטגרציה כדי שהלקוח יאותר באותה קבוצה.

• השתמשו בערך mediaType קבוע עבור אותו ערוץ.

• שלחו direction=incoming להודעת לקוח ו־direction=outgoing להודעת נציג.

• ערך Custom ריק אינו מוחק מידע קיים.

• שמרו אצלכם את subscriberID ואת activityID לצורך לוג ובקרה.

• מספר הטלפון עובר ניקוי של +, רווחים, מקפים ונקודות.

• הלקוח מאותר בתוך הקבוצה שנשלחה. אותו טלפון בקבוצה אחרת עשוי ליצור רשומה נוספת.

• מומלץ לבצע את הקריאות מצד שרת ולא מתוך דפדפן ציבורי.