Vai al contenuto

Profiles

I volti che tu e la tua azienda mostrate.

Apri Profiles
Verificato rispetto alla dashboard il 20 novembre 2026

Profiles ha sei metodi pubblici per i profili stessi: elenca, crea, modifica, archivia, ripristina ed elimina. Un altro imposta a quali profili appartiene un elemento, e tre appartengono a Phone e riguardano le regole di risposta e l'identità aziendale di un profilo. Ogni metodo agisce per l'account di cui usi la chiave API.

Scegliere un piano Profiles, invitare un membro, scegliere l'assistente di un profilo e collegare un numero non hanno oggi alcun metodo pubblico. Si fanno nella dashboard.

Invia una richiesta a un metodo con la tua chiave:

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',
    },
)

Una richiesta rifiutata risponde con un code negativo e ne spiega il motivo in data. Ogni metodo accetta anche un workspace_id facoltativo, per agire in un workspace di tua proprietà diverso da quello principale.

Leggere i profili

get_account_profiles elenca i profili del workspace, dal più recentemente modificato.

  • _id o profile_id restituisce un solo profilo.
  • filter_type restringe l'elenco: archived per i profili archiviati, shared per i profili condivisi con te, favorites per quelli segnati con il cuore. Se omesso, elenca ogni profilo attivo.
  • account_type restringe per tipo: personal, business o virtual.
  • folder_id elenca una cartella della dashboard, oppure __none__ per i profili senza cartella. search, limit, skip e bookmark paginano e filtrano l'elenco.

Creare un profilo

create_account_profile richiede un profile_name e un account_type, e facoltativamente un profile_signature (la descrizione), un'immagine e un avatar, e un email_account_id per collegare una casella di posta connessa.

  • Un profilo virtual richiede anche virtual_character, la descrizione da cui viene disegnato il suo ritratto, e virtual_traits, una scelta ciascuno per età, genere, etnia e aspetto. Viene rifiutato a meno che il piano Profiles del workspace includa i profili virtuali (Starter e superiori) o l'account abbia un abbonamento a pagamento, e l'account sia stato verificato.
  • Un profilo personal di un account personale, o un profilo business di un account business, parte con l'immagine e l'avatar dell'account stesso se non ne invii nessuno.
  • Un workspace che contiene già tanti profili quanti ne consente il suo piano rifiuta un nuovo profilo con code -62 e reason plan_cap. Conserva i profili che ha. Il profilo principale con cui parte un account o un workspace non viene mai rifiutato.

Modificare un profilo

update_account_profile richiede l'_id del profilo e uno qualsiasi dei campi che vuoi cambiare: il nome, la descrizione, l'immagine e l'avatar, email_account_id, account_type, il personaggio e i tratti virtuali, e registered_apps e registered_mini_apps, che decidono i moduli che ottengono una scheda su ogni contatto del profilo (registered_apps è l'intero elenco ordinato).

  • Passare un profilo a virtual richiede gli stessi requisiti della sua creazione.
  • Un profilo condiviso con te è una copia: il suo canvas è organizzato dal proprietario, quindi una modifica a canvas su di esso viene rifiutata.

Archiviare, ripristinare ed eliminare

  • archive_account_profile richiede profile_id e sposta il profilo in Archiviati. Il profilo principale viene rifiutato. Se il profilo era quello in uso in quel workspace, il workspace torna al suo profilo principale.
  • unarchive_account_profile riporta indietro un profilo archiviato. Conta di nuovo nel limite del piano, quindi un workspace pieno lo rifiuta. Un profilo arrivato con una condivisione di team non può essere ripristinato in questo modo.
  • delete_account_profile elimina definitivamente un profilo archiviato, insieme alle chat che ne dipendono. Accetta solo un profilo archiviato: prima archivia, poi elimina.
L'eliminazione non può essere annullata

Un profilo eliminato con delete_account_profile non esiste più, e nemmeno le chat collegate. L'archiviazione è il passaggio da usare quando vuoi solo toglierlo di mezzo.

Impostare a quali profili appartiene un elemento

update_entity_account_profiles richiede l'_id dell'elemento e un elenco account_profiles non vuoto, e imposta a quali profili appartiene quell'elemento. Funziona su un contatto, una chat, un assistente AI, un agente AI e una mini app, e rifiuta qualsiasi altro tipo di elemento.

La linea telefonica di un profilo

Tre metodi di Phone richiedono un profilo. Sono elencati insieme agli altri metodi di Phone, e il profilo è il modo in cui trovano il suo numero.

Come ti sembra questa guida?

Ultimo aggiornamento il 16 novembre 2026