Preskočiť na obsah
Overené

Pridať kontakt

Zaraďte osobu do knihy kontaktov ručne a ošetrite prípad, keď už v nej je.

create_contact je cesta do knihy kontaktov cez ručne zadané údaje, tá istá, ktorá stojí za vlastným formulárom „pridať kontakt“ v dashboarde: meno a e-mail, s telefónom a firmou ako bonusom. Kniha je indexovaná podľa e-mailu, takže poslanie e-mailu, ktorý už existuje, nie je chyba, vráti sa ako bežný úspech s uvedením kontaktu, ktorý už máte.

Method

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.

Walkthrough

Send the four fields a contact has

name a email sú jediné dve polia, ktoré create_contact vyžaduje. source má predvolenú hodnotu manual a context hodnotu Added by hand, ak ich vynecháte, obe sa zobrazia v histórii aktivity samotného 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'])

The response

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 knihe bol a contact_id uvádza kontakt, ktorý ho už mal, nie nový. Rozlíšte oba prípady podľa existed, nie podľa code, obidva sa vrátia ako code: 1.

phone a company sa na kontakte ukladajú, ale v tejto odpovedi sa nevracajú; prečítajte ich späť cez get_contacts alebo get_contact_members, ak potrebujete potvrdiť, čo sa uložilo.

Errors

Next