דילוג לתוכן
אומת

הוספת איש קשר

רישום אדם בפנקס אנשי הקשר ביד, וטיפול במקרה שהוא כבר נמצא בו.

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

שיטה

POST/cpi/create_contact
user

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 אם משמיטים אותם, ושניהם מוצגים במעקב הפעילות של איש הקשר.

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "name": "Priya Shah",
    "email": "[email protected]",
    "phone": "+1 555 0110",
    "company": "Northwind"
  }'
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: 'Priya Shah',
    email: '[email protected]',
    phone: '+1 555 0110',
    company: 'Northwind',
  }),
});
const { code, data } = await res.json();
if (code > 0 && data.existed) console.log('already in the book:', data.contact_id);
else if (code > 0) console.log('created:', data.contact_id);
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Priya Shah',
        'email': '[email protected]',
        'phone': '+1 555 0110',
        'company': 'Northwind',
    },
)
body = res.json()
if body['code'] > 0 and body['data']['existed']:
    print('already in the book:', body['data']['contact_id'])
elif body['code'] > 0:
    print('created:', body['data']['contact_id'])

התשובה

json
{
  "code": 1,
  "data": {
    "contact_id": "cnt_a91f0e",
    "name": "Priya Shah",
    "email": "[email protected]",
    "existed": false
  }
}

existed: true הוא מסלול הכפילות: האימייל כבר היה בפנקס, ו-contact_id מציין את איש הקשר שכבר החזיק בו ולא איש קשר חדש. כדי להבדיל בין שני המקרים מסתעפים לפי existed, לא לפי code, שניהם חוזרים עם code: 1.

phone ו-company נשמרים באיש הקשר אבל לא מוחזרים בתשובה הזו; קוראים אותם בחזרה עם get_contacts או get_contact_members אם צריך לאשר מה נשמר.

שגיאות

הבא