Profiles
הפנים שאתם והעסק שלכם מציגים.
לפרופילים יש שש שיטות ציבוריות לפרופילים עצמם: רשימה, יצירה, שינוי, העברה לארכיון, שחזור ומחיקה. שיטה נוספת אחת קובעת לאילו פרופילים פריט שייך, ושלוש שייכות ל-Phone ומכסות את כללי המענה והזהות העסקית של פרופיל. כל אחת פועלת עבור החשבון שמפתח ה-API שלו משתמשים בו.
בחירת תוכנית פרופילים, הזמנת חבר, בחירת העוזר של פרופיל וחיבור מספר אין להם שיטה ציבורית כיום. אלה נעשים בלוח הבקרה.
שולחים בקשה לשיטה עם המפתח שלכם:
בקשה שנדחתה עונה code שלילי ואומרת מדוע ב-data. כל שיטה מקבלת גם workspace_id אופציונלי, כדי לפעול בסביבת עבודה שבבעלותכם שאינה סביבת הבית שלכם.
לקרוא פרופילים
get_account_profiles מפרטת את הפרופילים של סביבת העבודה, מי ששונה לאחרונה ראשון.
_idאוprofile_idמחזירים פרופיל אחד.filter_typeמצמצם את הרשימה:archivedלפרופילים בארכיון,sharedלפרופילים ששיתפו איתכם,favoritesלאלה שמסומנים בלב. אם הוא לא צוין, היא מפרטת כל פרופיל פעיל.account_typeמצמצם לפי סוג:personal,businessאוvirtual.folder_idמפרט תיקייה אחת של לוח הבקרה, או__none__לפרופילים שאינם באף תיקייה.search,limit,skipו-bookmarkמדפדפים ומחפשים ברשימה.
ליצור פרופיל
create_account_profile מקבלת profile_name ו-account_type, ואופציונלית profile_signature (התיאור), תמונה ואווטאר, ו-email_account_id כדי לחבר תיבת דואר מחוברת.
- פרופיל וירטואלי מקבל גם
virtual_character, התיאור שממנו מצויר הדיוקן שלו, ו-virtual_traits, בחירה אחת לכל אחד מגיל, מגדר, מוצא ומראה. הוא נדחה אלא אם תוכנית הפרופילים של סביבת העבודה כוללת פרופילים וירטואליים (Starter ומעלה) או שיש לחשבון חברות בתשלום, והחשבון אומת. - פרופיל אישי של חשבון אישי, או פרופיל עסקי של חשבון עסקי, מתחיל עם התמונה והאווטאר של החשבון עצמו כשלא שולחים אחרים.
- סביבת עבודה שכבר מחזיקה כמה פרופילים שהתוכנית שלה מאפשרת דוחה חדש עם
code-62 ו-reasonplan_cap. היא שומרת על הפרופילים שיש לה. הפרופיל הראשי שחשבון או סביבת עבודה מתחילים איתו לעולם לא נדחה.
לשנות פרופיל
update_account_profile מקבלת את ה-_id של הפרופיל וכל אחד מהשדות שרוצים לשנות: השם, התיאור, התמונה והאווטאר, email_account_id, account_type, הדמות והתכונות הווירטואליות, ו-registered_apps ו-registered_mini_apps, שקובעים את המודולים שיש להם לשונית בכל איש קשר בפרופיל (registered_apps הוא הרשימה המסודרת כולה).
- המעבר של פרופיל לוירטואלי עובר את אותו סף כמו יצירה של אחד.
- פרופיל ששיתפו איתכם הוא עותק: הבעלים שלו מסדר את הקנבס שלו, ולכן שינוי ב-
canvasשלו נדחה.
העברה לארכיון, שחזור ומחיקה
archive_account_profileמקבלתprofile_idומעבירה את הפרופיל לארכיון. הפרופיל הראשי נדחה. אם הפרופיל היה זה שבשימוש בסביבת העבודה הזו, סביבת העבודה חוזרת לפרופיל הראשי שלה.unarchive_account_profileמחזירה פרופיל מהארכיון. הוא נספר שוב מול מגבלת התוכנית, ולכן סביבת עבודה מלאה דוחה אותו. פרופיל שהגיע עם שיתוף צוות אי אפשר לשחזר בדרך הזו.delete_account_profileמוחקת פרופיל שבארכיון לצמיתות, ואיתו את הצ'אטים שתלויים בו. היא מקבלת רק פרופיל שבארכיון: קודם מעבירים לארכיון, ואז מוחקים.
פרופיל שנמחק עם delete_account_profile נעלם, וגם הצ'אטים שמחוברים אליו. העברה לארכיון היא השלב המתאים כשרוצים רק להזיז פרופיל מהדרך.
לקבוע לאילו פרופילים פריט שייך
update_entity_account_profiles מקבלת את ה-_id של הפריט ורשימה לא ריקה account_profiles, וקובעת לאילו פרופילים הפריט הזה שייך. היא פועלת על איש קשר, צ'אט, עוזר AI, סוכן AI ואפליקציית מיני, ודוחה כל סוג אחר של פריט.
קו הטלפון של פרופיל
שלוש שיטות של Phone מקבלות פרופיל. הן מפורטות עם שאר השיטות של Phone, ופרופיל הוא הדרך שבה הן מוצאות את המספר שלו.
get_profile_answering_rulesקוראת את כללי המענה של קו (שעות עבודה, זמן קצוב לצלצול, למי מצלצלים, העברה, תא קולי והקלטה) ומה שהתוכנית הנוכחית מאפשרת.update_profile_answering_rulesשומרת אותם. הגדרה שהתוכנית לא כוללת נדחית ולא מושמטת.update_profile_business_identityשומרת את הזהות העסקית בפרופיל שיהיה הבעלים של המספר.