Μετάβαση στο περιεχόμενο

Επαφές

Οι άνθρωποι και οι εταιρείες με τις οποίες συνεργάζεστε.

Άνοιγμα του Επαφές
Ελέγχθηκε με τον πίνακα ελέγχου στις 20 Νοεμβρίου 2026

Οι Επαφές δεν έχουν δικό τους microservice. Οι δημόσιες μέθοδοί τους ανήκουν στο microservice account, που κρατά και τα Προφίλ, και στο microservice team για τα αιτήματα φιλίας. Καθεμία ενεργεί για τον λογαριασμό του οποίου το κλειδί API χρησιμοποιείτε.

Οι ομάδες, οι ετικέτες, τα προσαρμοσμένα πεδία, το Κρατήστε επαφή, ο έλεγχος διπλοτύπων, η εισαγωγή και η επιλογή πλάνου δεν έχουν σήμερα δημόσια μέθοδο. Αυτά γίνονται στο dashboard.

Στείλτε ένα αίτημα σε μια μέθοδο με το κλειδί σας:

curl -s https://xuda.ai/cpi/create_contact \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","name":"Dana Levi","email":"[email protected]","company":"Levi Studio"}'
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: 'Dana Levi',
    email: '[email protected]',
    company: 'Levi Studio',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_contact',
    json={
        'api_key': 'YOUR_API_KEY',
        'name': 'Dana Levi',
        'email': '[email protected]',
        'company': 'Levi Studio',
    },
)

Ένα αίτημα που απορρίπτεται απαντά με αρνητικό code και λέει γιατί στο data. Οι περισσότερες από τις παρακάτω μεθόδους δέχονται επίσης ένα προαιρετικό workspace_id, για να ενεργήσουν σε χώρο εργασίας που κατέχετε και δεν είναι ο αρχικός σας.

Διαβάστε επαφές

Το get_contacts απαριθμεί τις επαφές.

  • Το _id ή το contact_id επιστρέφει μία επαφή.
  • Το search φιλτράρει τη λίστα με μια συμβολοσειρά αναζήτησης, και το name με ένα όνομα.
  • Το filter_type περιορίζει τη λίστα, για παράδειγμα σε archived, shared, pinned, favorites ή online. Αν παραλειφθεί, απαριθμεί τις ενεργές επαφές μαζί με τα αιτήματα σύνδεσης που περιμένουν.
  • Το with_requests με τιμή true προσθέτει και σε μια φιλτραρισμένη λίστα τα εκκρεμή αιτήματα, απεσταλμένα και ληφθέντα.
  • Το tag απαριθμεί τις επαφές που φέρουν μία ετικέτα, το folder_id απαριθμεί έναν φάκελο (στείλτε __none__ για τις επαφές που δεν είναι σε κανέναν φάκελο), και το group_id απαριθμεί τα μέλη μιας ομάδας επαφών.
  • Το profile_id διαβάζει τις επαφές ενός άλλου προφίλ σας. Τα limit, skip και bookmark σελιδοποιούν τη λίστα.

Προσθέστε μια επαφή

Το create_contact προσθέτει ένα άτομο με το χέρι. Δέχεται τα name και email, που είναι υποχρεωτικά, και προαιρετικά τα phone, company, job_title, και το account_type με τιμή personal ή business, που γλιτώνει από ένα μοντέλο τον κόπο της εικασίας.

  • Το email είναι το κλειδί του βιβλίου. Η αποστολή ενός που ήδη κρατάτε επιστρέφει την υπάρχουσα επαφή αντί για δεύτερο αντίγραφο.
  • Το source καταγράφει από πού ήρθε η επαφή, manual όταν δεν στέλνετε κανένα, και το context είναι μία γραμμή που εμφανίζεται στη δραστηριότητα της επαφής.
  • Το profile_id καταχωρίζει την επαφή κάτω από ένα άλλο προφίλ σας.
  • Δεν ρωτιέται κανείς τίποτα και δεν στέλνεται κανένα email. Είναι το ίδιο με το Προσθήκη χωρίς πρόσκληση στο dashboard.

Για να φέρετε μια λίστα από κώδικα, καλέστε το μία φορά για κάθε άτομο.

Αιτήματα φιλίας

  • Το add_contact_member στέλνει ένα αίτημα σε έναν άλλον χρήστη Xuda, που βρίσκεται με το access_email ή με το to_uid.
  • Το get_contact_members απαριθμεί τα αιτήματα και τις συνδέσεις σας, καθεμία με την κάρτα του άλλου ατόμου. Το stat δέχεται μία κατάσταση αιτήματος, ή περισσότερες, για να απαριθμήσει.
  • Το unfriend_contact δέχεται ένα contact_id και τερματίζει τη σύνδεση. Η επαφή μένει στο βιβλίο σας.

Οργανώστε μια επαφή

Καθεμία από αυτές δέχεται ένα contact_id.

  • Τα favorite_contact και unfavorite_contact ορίζουν και αφαιρούν την καρδιά, που είναι αυτό που απαριθμεί η επιλογή Αγαπημένα του Φίλτρου.
  • Τα pin_contact και unpin_contact καρφιτσώνουν μια επαφή και αφαιρούν το καρφίτσωμα.
  • Το set_not_contact μετακινεί έναν αποστολέα από τη λίστα στις Μη επαφές, για τις ειδοποιήσεις μιας τράπεζας, τις αποδείξεις ενός καταστήματος ή μια διεύθυνση no-reply. Το mail του εξακολουθεί να διαβάζεται όπως πριν. Το unset_not_contact το επαναφέρει και το κρατά εκεί.
  • Το not_spam_contact σημειώνει μια επαφή ως μη spam και εμπιστεύεται τη διεύθυνσή της.
  • Το set_deep_research_contact ενεργοποιεί τη βαθιά έρευνα για μια επαφή, και το unset_deep_research_contact την απενεργοποιεί και καθαρίζει όσα κράτησε.
  • Το generate_contact_avatar καθαρίζει τις εικόνες μιας επαφής και σχεδιάζει ένα νέο avatar. Δεν είναι διαθέσιμο σε δωρεάν λογαριασμούς.

Αρχειοθετήστε και διαγράψτε

  • Το archive_contact μετακινεί μια επαφή στο Αρχειοθετήθηκε.
  • Το unarchive_contact την επαναφέρει.
  • Το delete_contact διαγράφει μια επαφή. Στο dashboard μόνο μια αρχειοθετημένη επαφή μπορεί να διαγραφεί, οπότε αρχειοθετήστε πρώτα.
Η διαγραφή δεν αναιρείται

Μια επαφή που διαγράφηκε με το delete_contact έχει χαθεί. Η αρχειοθέτηση είναι το βήμα που πρέπει να χρησιμοποιήσετε όταν θέλετε απλώς να βγάλετε μια επαφή από τη μέση.

Πώς σας φαίνεται αυτός ο οδηγός;

Τελευταία ενημέρωση: 20 Νοεμβρίου 2026