Přeskočit na obsah
Ověřeno

Přidat kontakt

Zapište osobu do knihy kontaktů ručně a ošetřete případ, kdy už v ní je.

create_contact je ručně zadaná cesta do knihy kontaktů, tatáž, která stojí za vlastním formulářem „přidat kontakt“ v nástěnce: jméno a e-mail, k tomu telefon a firma. Kniha je klíčována podle e-mailu, takže poslat e-mail, který už existuje, není chyba, vrátí se jako běžný úspěch, který pojmenuje kontakt, který už máte.

Metoda

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.

Postup

Poslat čtyři pole, která kontakt má

name a email jsou jediná dvě pole, která create_contact vyžaduje. source má výchozí hodnotu manual a context hodnotu Added by hand, pokud je vynecháte, obojí se zobrazuje ve vlastní historii aktivity kontaktu.

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

Odpověď

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

existed: true je cesta duplikátu: e-mail už v knize byl a contact_id pojmenovává kontakt, který ho už měl, ne nový. K rozlišení obou případů větvete podle existed, ne podle code, oba se vrací jako code: 1.

phone a company se u kontaktu ukládají, ale v této odpovědi se nevracejí; chcete-li ověřit, co se uložilo, přečtěte je zpět přes get_contacts nebo get_contact_members.

Chyby

Dále