דילוג לתוכן

אנשי קשר

האנשים והחברות שאתם עובדים איתם.

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

לאנשי קשר אין מיקרו-שירות משלו. השיטות הציבוריות שלו שייכות למיקרו-שירות account, שמחזיק גם את Profiles, ולמיקרו-שירות team לבקשות חברות. כל שיטה פועלת עבור החשבון שמפתח ה-API שלו משמש אתכם.

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

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

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","name":"Dana Levi","email":"[email protected]","company":"Levi Studio"}'
const res = await fetch('https://xuda.ai/cpi/create_contact', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    name: 'Dana Levi',
    email: '[email protected]',
    company: 'Levi Studio',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Dana Levi',
        'email': '[email protected]',
        'company': 'Levi Studio',
    },
)

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

קריאת אנשי קשר

get_contacts מציגה רשימה של אנשי הקשר.

  • _id או contact_id מחזירים איש קשר אחד.
  • search מסנן את הרשימה לפי מחרוזת חיפוש, ו-name לפי שם.
  • filter_type מצמצם את הרשימה, למשל ל-archived, shared, pinned, favorites או online. אם משמיטים אותו, מוצגים אנשי הקשר הפעילים יחד עם בקשות החברות שממתינות.
  • with_requests שמוגדר ל-true מוסיף את הבקשות הממתינות, שנשלחו ושהתקבלו, גם לרשימה מסוננת.
  • tag מציג את אנשי הקשר שנושאים תגית אחת, folder_id מציג תיקייה אחת (שולחים __none__ לאנשי קשר שאינם באף תיקייה), ו-group_id מציג את חברי קבוצת אנשי קשר אחת.
  • profile_id קורא את אנשי הקשר של פרופיל אחר שלכם. limit, skip ו-bookmark מדפדפים ברשימה.

הוספת איש קשר

create_contact מוסיפה אדם ביד. היא מקבלת name ו-email, שהם חובה, ואופציונלית phone, company, job_title, ו-account_type שמוגדר ל-personal או business, וזה חוסך למודל את הניחוש.

  • האימייל הוא המפתח של הספר. שליחת אימייל שכבר יש לכם מחזירה את איש הקשר הקיים במקום עותק שני.
  • source רושם מאיפה איש הקשר הגיע, manual אם לא שולחים, ו-context היא שורה אחת שמוצגת בפעילות של איש הקשר.
  • profile_id מסווג את איש הקשר תחת פרופיל אחר שלכם.
  • אף אחד לא נשאל דבר ולא נשלח אימייל. זה כמו הוספה בלי הזמנה בדשבורד.

כדי להביא רשימה מקוד, קוראים לשיטה פעם אחת לכל אדם.

בקשות חברות

  • add_contact_member שולחת בקשה למשתמש Xuda אחר, שנמצא לפי access_email או לפי to_uid.
  • get_contact_members מציגה את הבקשות והחיבורים שלכם, כל אחד עם הכרטיס של האדם השני. stat מקבל סטטוס בקשה אחד, או כמה, להצגה.
  • unfriend_contact מקבלת contact_id ומסיימת את החיבור. איש הקשר נשאר בספר שלכם.

ארגון איש קשר

כל אחת מאלה מקבלת contact_id.

  • favorite_contact ו-unfavorite_contact מדליקות ומכבות את הלב, שהוא מה שהבחירה מועדפים בסינון מציגה.
  • pin_contact ו-unpin_contact מצמידות איש קשר ומסירות את ההצמדה.
  • set_not_contact מעבירה שולח מהרשימה אל לא אנשי קשר, להתראות של בנק, לקבלות של חנות או לכתובת no-reply. הדואר שלו עדיין נקרא כמו קודם. unset_not_contact מחזירה אותו ומשאירה אותו שם.
  • not_spam_contact מסמנת איש קשר כלא ספאם וסומכת על הכתובת שלו.
  • set_deep_research_contact מפעילה מחקר מעמיק עבור איש קשר, ו-unset_deep_research_contact מכבה אותו ומנקה את מה ששמר.
  • generate_contact_avatar מנקה את התמונות של איש קשר ומצייר אווטאר חדש. היא לא זמינה בחשבונות חינמיים.

העברה לארכיון ומחיקה

  • archive_contact מעבירה איש קשר אל בארכיון.
  • unarchive_contact מחזירה אותו.
  • delete_contact מוחקת איש קשר. בדשבורד אפשר למחוק רק איש קשר שנמצא בארכיון, ולכן מעבירים לארכיון קודם.
אי אפשר לבטל מחיקה

איש קשר שנמחק עם delete_contact נעלם. העברה לארכיון היא הצעד המתאים כשרק רוצים להוריד איש קשר מהדרך.

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

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