Przejdź do treści
Zweryfikowano

Dodaj kontakt

Wpisz osobę do książki kontaktów ręcznie i obsłuż przypadek, gdy już w niej jest.

create_contact to ścieżka wpisywania do książki kontaktów, ta sama, która stoi za własnym formularzem „dodaj kontakt" w pulpicie: imię i e-mail, a do tego telefon i firma. Książka jest kluczowana e-mailem, więc wysłanie takiego, który już istnieje, nie jest błędem, wraca jako zwykły sukces wskazujący kontakt, który już masz.

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.

Krok po kroku

Wyślij cztery pola, które ma kontakt

name i email to jedyne dwa pola, których wymaga create_contact. source domyślnie ma wartość manual, a context wartość Added by hand, jeśli je pominiesz; oba widać na własnej osi aktywności 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'])

Odpowiedź

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

existed: true to ścieżka duplikatu: e-mail był już w książce, a contact_id wskazuje kontakt, który już go miał, a nie nowy. Rozróżniaj te dwa przypadki po existed, a nie po code, bo oba wracają jako code: 1.

phone i company są zapisane w kontakcie, ale nie są zwracane w tej odpowiedzi; odczytaj je przez get_contacts lub get_contact_members, jeśli chcesz potwierdzić, co zapisano.

Błędy

Dalej