Μετάβαση στο περιεχόμενο
Επαληθεύτηκε

Προσθήκη επαφής

Καταχωρίστε ένα άτομο στο βιβλίο επαφών με το χέρι, και χειριστείτε την περίπτωση που υπάρχει ήδη εκεί.

Το create_contact είναι η διαδρομή πληκτρολόγησης προς το βιβλίο επαφών, η ίδια που βρίσκεται πίσω από τη φόρμα «προσθήκη επαφής» του πίνακα ελέγχου: ένα όνομα και ένα email, με τηλέφωνο και εταιρεία ως συνοδευτικά. Το βιβλίο έχει ως κλειδί το email, οπότε η αποστολή ενός που υπάρχει ήδη δεν είναι σφάλμα: επιστρέφει ως κανονική επιτυχία που ονομάζει την επαφή που ήδη έχετε.

Μέθοδος

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 είναι η διαδρομή του διπλότυπου: το email υπήρχε ήδη στο βιβλίο, και το contact_id ονομάζει την επαφή που το είχε ήδη και όχι μια νέα. Διακλαδιστείτε με βάση το existed, όχι το code, για να ξεχωρίσετε τις δύο περιπτώσεις: και οι δύο επιστρέφουν code: 1.

Τα phone και company αποθηκεύονται στην επαφή αλλά δεν επιστρέφονται σε αυτή την απάντηση: διαβάστε τα πίσω με get_contacts ή get_contact_members αν χρειάζεται να επιβεβαιώσετε τι αποθηκεύτηκε.

Σφάλματα

Επόμενο