איך מעבירים פרטים מה-API לסוכן

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

1. פתחו את "הגדרות הסוכן" ובחרו "התנהגות"

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

3. הקלידו @ ואת שם הפרט, ולחצו Enter

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

   

4. לחצו "שמור שינויים"

   המשתנה מופיע בתסריט כתגית.

5. שלחו בבקשה שדה באותו שם

   ברשימת חיוג: שדה בגוף הבקשה. בשיחה מיידית: שדה בתוך variables. דוגמאות בהמשך.

6. לחצו "שיחת בדיקה", מלאו ערך לכל משתנה תחת "ערכי הדגמה" ולחצו "התקשרו אליי"

   הסוכן פותח את השיחה עם הערכים שהזנתם.

   

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

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

curl -X POST '<ADDRESS_FROM_DEVELOPER_PAGE>' \
  -H 'Authorization: Bearer <API-KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "phone": "+9725XXXXXXXX",
    "first_name": "דנה",
    "car_model": "מאזדה 3"
  }'

לשיחה מיידית, שלחו את הפרטים בתוך variables בבקשה שמפעילה שיחה מיד:

curl -X POST 'https://platform.direnium.com/api/v1/calls' \
  -H 'Authorization: Bearer <API-KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "agentId": "<AGENT-ID>",
    "to": "+9725XXXXXXXX",
    "variables": { "first_name": "דנה", "car_model": "מאזדה 3" }
  }'

מה קורה כשפרט חסר או לא תואם?

• השם חייב להיות זהה, כולל אותיות גדולות וקטנות. Car_Model לא ממלא את car_model.
• ערך פשוט בלבד: טקסט, מספר או true/false. שדה עם אובייקט או רשימה בתוכו לא מגיע לסוכן.
• פרט בלי משתנה בתסריט לא מגיע לסוכן.
• משתנה בלי ערך: הסוכן יודע שהפרט חסר. הוא לא ממציא אותו ולא אומר שיש לו אותו, ואם הוא צריך את הפרט הוא שואל את הלקוח.

ראו גם: איך משלבים את שם הלקוח בשיחה ואיך יוצרים ומנהלים מפתחות API.