הוספת איש קשר
רישום אדם בפנקס אנשי הקשר ביד, וטיפול במקרה שהוא כבר נמצא בו.
create_contact היא הדרך להקליד איש קשר אל הפנקס, אותה דרך שעומדת מאחורי טופס
"הוספת איש קשר" בדשבורד עצמו: שם ואימייל, ועימם טלפון וחברה. הפנקס
ממופתח לפי אימייל, ולכן שליחת אימייל שכבר קיים אינה שגיאה, היא חוזרת כהצלחה רגילה שמציינת את איש הקשר
שכבר יש לכם.
שיטה
Create Contact
Adds a person to the contact book by hand, from typed details rather than from a received message. Takes only the fields a contact has, name, email, phone, company, job title and its kind (personal or business, which then needs no model to classify it), and ignores anything else the caller happens to hold, such as a shipping address. The email is the book's key, so it is required and a repeat of one already filed returns the existing contact instead of a second copy.
הדרכה צעד אחר צעד
שולחים את ארבעת השדות של איש קשר
name ו-email הם השניים היחידים ש-create_contact דורשת. source ברירת המחדל שלו היא manual ו-
context ברירת המחדל שלו היא Added by hand אם משמיטים אותם, ושניהם מוצגים במעקב הפעילות של איש הקשר.
התשובה
existed: true הוא מסלול הכפילות: האימייל כבר היה בפנקס, ו-contact_id מציין
את איש הקשר שכבר החזיק בו ולא איש קשר חדש. כדי להבדיל בין שני המקרים מסתעפים לפי existed, לא לפי code, שניהם
חוזרים עם code: 1.
phone ו-company נשמרים באיש הקשר אבל לא מוחזרים בתשובה הזו; קוראים אותם
בחזרה עם get_contacts או get_contact_members אם צריך לאשר מה נשמר.