Ugrás a tartalomhoz
Ellenőrizve

Kapcsolat hozzáadása

Vegyen fel egy személyt kézzel a névjegyzékbe, és kezelje azt az esetet, amikor már benne van.

A create_contact a begépelt út a névjegyzékbe, ugyanaz, amely az irányítópult saját „kapcsolat hozzáadása" űrlapja mögött áll: egy név és egy e-mail, mellé telefonszám és cég. A névjegyzéket az e-mail kulcsolja, ezért egy már létező cím küldése nem hiba: normál sikerként tér vissza, és megnevezi a már meglévő kapcsolatot.

Metódus

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.

Végigvezető

Küldje el a kapcsolat négy mezőjét

A create_contact csak a name és az email mezőt követeli meg. A source alapértéke manual, a context alapértéke Added by hand, ha kihagyja őket; mindkettő megjelenik a kapcsolat saját tevékenységi naplójában.

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'])

A válasz

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

Az existed: true a duplikátum útja: az e-mail már benne volt a névjegyzékben, és a contact_id azt a kapcsolatot nevezi meg, amelyiknek már megvolt, nem újat. A két eset megkülönböztetéséhez az existed értékre ágazzon el, ne a code értékre, mindkettő code: 1 értékkel jön vissza.

A phone és a company eltárolódik a kapcsolaton, de ebben a válaszban nem jön vissza; ha ellenőrizni szeretné, mi mentődött, olvassa vissza a get_contacts vagy a get_contact_members hívással.

Hibák

Következő