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

Προφίλ

Τα πρόσωπα που εμφανίζετε εσείς και η επιχείρησή σας.

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

Τα Προφίλ έχουν έξι δημόσιες μεθόδους για τα ίδια τα προφίλ: απαρίθμηση, δημιουργία, αλλαγή, αρχειοθέτηση, επαναφορά και διαγραφή. Μία ακόμη ορίζει σε ποια προφίλ ανήκει ένα στοιχείο, και τρεις ανήκουν στο Τηλέφωνο και καλύπτουν τους κανόνες απάντησης και την επαγγελματική ταυτότητα ενός προφίλ. Καθεμία ενεργεί για τον λογαριασμό του οποίου το κλειδί API χρησιμοποιείτε.

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

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

curl -s https://xuda.ai/cpi/create_account_profile \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","profile_name":"Support","account_type":"business"}'
const res = await fetch('https://xuda.ai/cpi/create_account_profile', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    profile_name: 'Support',
    account_type: 'business',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_account_profile',
    json={
        'api_key': 'YOUR_API_KEY',
        'profile_name': 'Support',
        'account_type': 'business',
    },
)

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

Διαβάστε προφίλ

Το get_account_profiles απαριθμεί τα προφίλ του χώρου εργασίας, τα πιο πρόσφατα αλλαγμένα πρώτα.

  • Το _id ή το profile_id επιστρέφει ένα προφίλ.
  • Το filter_type περιορίζει τη λίστα: archived για αρχειοθετημένα προφίλ, shared για προφίλ που κοινοποιήθηκαν σε εσάς, favorites για αυτά που σημειώθηκαν με την καρδιά. Αν παραλειφθεί, απαριθμεί κάθε ενεργό προφίλ.
  • Το account_type περιορίζει ανά είδος: personal, business ή virtual.
  • Το folder_id απαριθμεί έναν φάκελο του dashboard, ή __none__ για τα προφίλ που δεν είναι σε κανέναν φάκελο. Τα search, limit, skip και bookmark σελιδοποιούν και αναζητούν στη λίστα.

Δημιουργήστε ένα προφίλ

Το create_account_profile δέχεται ένα profile_name και ένα account_type, και προαιρετικά ένα profile_signature (την περιγραφή), μια εικόνα και ένα avatar, και ένα email_account_id για να συνδέσει ένα συνδεδεμένο γραμματοκιβώτιο.

  • Ένα virtual προφίλ δέχεται επίσης το virtual_character, την περιγραφή από την οποία σχεδιάζεται το πορτρέτο του, και το virtual_traits, μία επιλογή για καθένα από ηλικία, φύλο, εθνοτική καταγωγή και εμφάνιση. Απορρίπτεται εκτός αν το πλάνο Προφίλ του χώρου εργασίας περιλαμβάνει εικονικά προφίλ (Starter και πάνω) ή ο λογαριασμός έχει συνδρομή επί πληρωμή, και ο λογαριασμός έχει επαληθευτεί.
  • Ένα προσωπικό προφίλ ενός προσωπικού λογαριασμού, ή ένα επαγγελματικό προφίλ ενός επαγγελματικού λογαριασμού, ξεκινά με την εικόνα και το avatar του ίδιου του λογαριασμού όταν δεν στέλνετε κανένα.
  • Ένας χώρος εργασίας που έχει ήδη τόσα προφίλ όσα επιτρέπει το πλάνο του απορρίπτει ένα νέο με code -62 και reason plan_cap. Κρατά τα προφίλ που έχει. Το κύριο προφίλ με το οποίο ξεκινά ένας λογαριασμός ή χώρος εργασίας δεν απορρίπτεται ποτέ.

Αλλάξτε ένα προφίλ

Το update_account_profile δέχεται το _id του προφίλ και οποιοδήποτε από τα πεδία που θέλετε να αλλάξετε: το όνομα, την περιγραφή, την εικόνα και το avatar, το email_account_id, το account_type, τον εικονικό χαρακτήρα και τα χαρακτηριστικά, και τα registered_apps και registered_mini_apps, που αποφασίζουν τα modules που παίρνουν καρτέλα σε κάθε επαφή του προφίλ (το registered_apps είναι ολόκληρη η ταξινομημένη λίστα).

  • Η αλλαγή ενός προφίλ σε virtual περνά το ίδιο εμπόδιο με τη δημιουργία ενός.
  • Ένα προφίλ που κοινοποιήθηκε σε εσάς είναι αντίγραφο: ο ιδιοκτήτης του οργανώνει τον καμβά του, οπότε μια αλλαγή στο canvas σε αυτό απορρίπτεται.

Αρχειοθετήστε, επαναφέρετε και διαγράψτε

  • Το archive_account_profile δέχεται το profile_id και μετακινεί το προφίλ στο Αρχειοθετήθηκε. Το κύριο προφίλ απορρίπτεται. Αν το προφίλ ήταν αυτό που χρησιμοποιούνταν σε εκείνον τον χώρο εργασίας, ο χώρος εργασίας επιστρέφει στο κύριο προφίλ του.
  • Το unarchive_account_profile επαναφέρει ένα αρχειοθετημένο προφίλ. Μετράει ξανά στο όριο του πλάνου, οπότε ένας γεμάτος χώρος εργασίας το απορρίπτει. Ένα προφίλ που ήρθε με κοινοποίηση ομάδας δεν μπορεί να επαναφερθεί με αυτόν τον τρόπο.
  • Το delete_account_profile διαγράφει οριστικά ένα αρχειοθετημένο προφίλ, και μαζί του τις συνομιλίες που κρέμονται από αυτό. Δέχεται μόνο αρχειοθετημένο προφίλ: αρχειοθετήστε πρώτα, μετά διαγράψτε.
Η διαγραφή δεν αναιρείται

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

Ορίστε σε ποια προφίλ ανήκει ένα στοιχείο

Το update_entity_account_profiles δέχεται το _id του στοιχείου και μια μη κενή λίστα account_profiles, και ορίζει σε ποια προφίλ ανήκει εκείνο το στοιχείο. Λειτουργεί σε μια επαφή, μια συνομιλία, έναν βοηθό AI, έναν πράκτορα AI και μια mini app, και απορρίπτει οποιοδήποτε άλλο είδος στοιχείου.

Η τηλεφωνική γραμμή ενός προφίλ

Τρεις μέθοδοι του Τηλεφώνου δέχονται ένα προφίλ. Απαριθμούνται μαζί με τις υπόλοιπες μεθόδους του Τηλεφώνου, και ένα προφίλ είναι ο τρόπος με τον οποίο βρίσκουν τον αριθμό του.

  • Το get_profile_answering_rules διαβάζει τους κανόνες απάντησης μιας γραμμής (ώρες λειτουργίας, χρονικό όριο κουδουνίσματος, ποιος καλείται, προώθηση, φωνητικό μήνυμα και εγγραφή) και τι επιτρέπει το τρέχον πλάνο.
  • Το update_profile_answering_rules τους αποθηκεύει. Μια ρύθμιση που δεν περιλαμβάνει το πλάνο απορρίπτεται αντί να παραλειφθεί.
  • Το update_profile_business_identity αποθηκεύει την επαγγελματική ταυτότητα στο προφίλ που θα κατέχει τον αριθμό.

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

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