פתיחת קריאת תמיכה
שליחת קריאה בדלפק של התוכנית שלכם מתוך קוד חיצוני, ובדיקה חוזרת עד שמישהו עונה.
ticket_api_submit פותחת קריאה בדלפק שהתוכנית של מפתח ה-API שלכם מחזיקה, אותו דלפק
שמסך הקריאות בדשבורד מנהל. ticket_api_get קוראת אחת בחזרה, כולל התשובות
הציבוריות, כל מה שצריך כדי לבנות טופס "צרו קשר" שנתמך בדלפק אמיתי ולא בתיבת
דואר.
שיטות
API: Submit Ticket
External service: opens a ticket on the desk owned by the API key. Requires a plan with full API access.
API: Get Ticket
External service: one ticket with its public interactions. Internal notes are never returned.
הדרכה צעד אחר צעד
שולחים את הקריאה
name, email ו-details הם שדות חובה. האימייל משמש גם לחיפוש בפנקס אנשי הקשר:
שליחה חוזרת מאותה כתובת מתקשרת לאותו איש קשר, כמו ש
הוספת איש קשר עושה.
2. בודקים אם הגיעה תשובה
שומרים את data.id מקריאת השליחה וקוראים אותו בחזרה עם ticket_api_get בכל פעם שרוצים
לבדוק אם יש התקדמות; interactions נושא רק את השרשור הציבורי, הערות פנימיות של הדלפק
מסוננות החוצה לפני ששיטה זו עונה.
התשובה
שתי השיטות עונות באותה תצוגת קריאה צרה ובטוחה לחשיפה חיצונית, בלי מזהי בעלים ובלי מצב פנימי:
ticket_api_get מוסיפה מפתח אחד נוסף, interactions, מערך של { direction, from, channel, body, ts } לפי סדר השרשור, ריק עד שמישהו בדלפק (או הפונה, בערוץ אחר)
עונה.