דילוג לתוכן

Profiles

הפנים שאתם והעסק שלכם מציגים.

פתיחת Profiles
נבדק מול לוח הבקרה ב-20 בנובמבר 2026

לפרופילים יש שש שיטות ציבוריות לפרופילים עצמם: רשימה, יצירה, שינוי, העברה לארכיון, שחזור ומחיקה. שיטה נוספת אחת קובעת לאילו פרופילים פריט שייך, ושלוש שייכות ל-Phone ומכסות את כללי המענה והזהות העסקית של פרופיל. כל אחת פועלת עבור החשבון שמפתח ה-API שלו משתמשים בו.

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

שולחים בקשה לשיטה עם המפתח שלכם:

curl -s https://xuda.ai/cpi/create_account_profile \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","profile_name":"Support","account_type":"business"}'
const res = await fetch('https://xuda.ai/cpi/create_account_profile', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    profile_name: 'Support',
    account_type: 'business',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_account_profile',
    json={
        'api_key': 'YOUR_API_KEY',
        'profile_name': 'Support',
        'account_type': 'business',
    },
)

בקשה שנדחתה עונה 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 ו-reason plan_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 שומרת את הזהות העסקית בפרופיל שיהיה הבעלים של המספר.

איך המדריך הזה?

עודכן לאחרונה ב-16 בנובמבר 2026