מרכז ידע English כניסה למערכת
נושאים

איך מפעילים שיחות דרך API

עודכן 5 באוקטובר 2026 דקת קריאה

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

  1. פתחו את "הגדרות הסוכן", ואז "שיחות יוצאות"

  2. תחת "מה מפעיל שיחה?" בחרו "API" ולחצו "להגדרה"

    השאלה מה מפעיל שיחה, האפשרות API מסומנת ומתחתיה הכפתור להגדרה
  3. תנו שם לרשימה ולחצו "הבא"

  4. סמנו אילו פרטים המערכת שלכם שולחת על כל ליד, ולחצו "סיום"

    טלפון נשלח תמיד. כל פרט אחר מגיע לסוכן כשיש בתסריט משתנה באותו שם. "+ פרט" מוסיף פרט חדש.

    החלון מה המערכת שלכם תשלח על כל ליד: טלפון, first_name, car_model והאפשרות להוסיף פרט
  5. הרשימה נוצרת כבויה

    ברירת המחדל: כל ליד, בשעות הפעילות, ניסיון אחד. משנים בשורות "מי", "מתי" ו"כמה".

    כרטיס רשימת API במצב כבויה, עם השורות חיבור, מי, מתי וכמה והכפתורים לשלוח למפתח ולבדוק עכשיו

איך שולחים את הפרטים למפתח?

  1. בכרטיס הרשימה לחצו "לשלוח למפתח"

  2. לחצו "מפתח חדש"

    רק אחרי הלחיצה הקישור כולל גם את המפתח.

    חלון חיבור אחרי יצירת מפתח חדש: הקישור מציג למפתח את הכתובת, השדות, דוגמה ואת המפתח פעם אחת
  3. שלחו את הקישור עם "העתקת הודעה" או "שיתוף"

למפתחים

עמוד המפתחים: הודעה שהרשימה כבויה וטבלת השדות phone, first_name ו-car_model
בקשה לדוגמה
curl -X POST '<ADDRESS_FROM_DEVELOPER_PAGE>' \
  -H 'Authorization: Bearer <API-KEY>' \
  -H 'Content-Type: application/json' \
  -H 'X-Idempotency-Key: lead-48213' \
  -d '{
    "phone": "+9725XXXXXXXX",
    "first_name": "דנה",
    "car_model": "מאזדה 3"
  }'
שדות הבקשה
שדהתיאור
phonestringחובהמספר הטלפון של הליד, כמחרוזת.
first_name, car_model…stringרשותשדה ששמו זהה לשם של משתנה בתסריט מגיע לסוכן.
X-Idempotency-Keyheaderרשותבקשה חוזרת עם אותו מזהה לא יוצרת ליד כפול.
  • 202: הליד התקבל. התשובה כוללת jobId.
  • 200 עם "status": "skipped": הרשימה כבויה.
  • 422: חסר טלפון, או שהוא לא תקין.
  • 401: המפתח חסר או שגוי.
  • 429: יותר מדי בקשות בדקה.

איך בודקים ומפעילים?

  1. לחצו "לבדוק עכשיו" והזינו את המספר שלכם

    הסוכן מתקשר אליכם גם כשהרשימה כבויה. המספר נשמר כמספר בדיקה.

  2. הדליקו את המתג בכרטיס הרשימה

    ליד הכותרת מופיע "פעילה". מה קרה לכל ליד רואים ב"יומן".

ראו גם: איך מעבירים פרטים מה-API לסוכן, איך הסוכן מתקשר ללידים מה-CRM ואיך משלבים את שם הלקוח בשיחה.

מאמרים נוספים בנושא

    ↑↓ניווט Enterפתיחה Escסגירה מחפש במאמרים בעברית · English