אנשי קשר
האנשים והחברות שאתם עובדים איתם.
לאנשי קשר אין מיקרו-שירות משלו. השיטות הציבוריות שלו שייכות למיקרו-שירות account, שמחזיק גם את Profiles, ולמיקרו-שירות team לבקשות חברות. כל שיטה פועלת עבור החשבון שמפתח ה-API שלו משמש אתכם.
לקבוצות, תגיות, שדות מותאמים, שמירה על קשר, בדיקת כפילויות, ייבוא ובחירת תוכנית אין היום שיטה ציבורית. את אלה עושים בדשבורד.
שולחים בקשה לשיטה עם המפתח שלכם:
בקשה שנדחתה מחזירה 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 נעלם. העברה לארכיון היא הצעד המתאים כשרק רוצים להוריד איש קשר מהדרך.