Sari la conținut

Profiluri

Fețele pe care le arăți tu și afacerea ta.

Deschide Profiluri
Verificat față de tabloul de bord la 20 noiembrie 2026

Profiluri are șase metode publice pentru profilurile în sine: listare, creare, schimbare, arhivare, restaurare și ștergere. Încă una setează cărui profil aparține un element, iar trei aparțin Telefonului și acoperă regulile de răspuns și identitatea de afacere ale unui profil. Fiecare acționează pentru contul a cărui cheie API o folosești.

Alegerea unui plan Profiluri, invitarea unui membru, alegerea asistentului unui profil și atașarea unui număr nu au nicio metodă publică astăzi. Acestea se fac în dashboard.

Trimite o cerere către o metodă cu cheia ta:

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

O cerere refuzată răspunde cu un code negativ și spune de ce în data. Fiecare metodă primește și un workspace_id opțional, pentru a acționa într-un spațiu de lucru pe care îl deții, altul decât cel principal.

Citește profiluri

get_account_profiles listează profilurile spațiului de lucru, cele schimbate cel mai recent primele.

  • _id sau profile_id returnează un singur profil.
  • filter_type restrânge lista: archived pentru profilurile arhivate, shared pentru profilurile distribuite cu tine, favorites pentru cele marcate cu inimă. Dacă este omis, listează fiecare profil activ.
  • account_type restrânge după tip: personal, business sau virtual.
  • folder_id listează un folder din dashboard sau __none__ pentru profilurile fără folder. search, limit, skip și bookmark paginează și caută în listă.

Creează un profil

create_account_profile primește un profile_name și un account_type și opțional un profile_signature (descrierea), o imagine și un avatar și un email_account_id pentru a atașa o căsuță de e-mail conectată.

  • Un profil virtual primește și virtual_character, descrierea din care se desenează portretul lui, și virtual_traits, câte o alegere pentru vârstă, gen, etnie și aspect. Este refuzat dacă planul Profiluri al spațiului de lucru nu include profiluri virtuale (Starter și mai sus) sau contul nu are un abonament plătit, iar contul trebuie să fie verificat.
  • Un profil personal al unui cont personal sau un profil de afacere al unui cont de afacere pornește cu imaginea și avatarul propriu ale contului când nu trimiți niciunul.
  • Un spațiu de lucru care deține deja tot atâtea profiluri cât permite planul lui refuză unul nou cu code -62 și reason plan_cap. Își păstrează profilurile pe care le are. Profilul principal cu care pornește un cont sau un spațiu de lucru nu este niciodată refuzat.

Schimbă un profil

update_account_profile primește _id-ul profilului și oricare dintre câmpurile pe care vrei să le schimbi: numele, descrierea, imaginea și avatarul, email_account_id, account_type, personajul și trăsăturile virtuale și registered_apps și registered_mini_apps, care decid modulele ce primesc o filă pe fiecare contact din profil (registered_apps este întreaga listă ordonată).

  • Trecerea unui profil la virtual trebuie să îndeplinească aceleași condiții ca și crearea unuia.
  • Un profil care a fost distribuit cu tine este o copie: proprietarul lui își aranjează canvasul, așa că o schimbare a canvas pe el este refuzată.

Arhivează, restaurează și șterge

  • archive_account_profile primește profile_id și mută profilul la Arhivat. Profilul principal este refuzat. Dacă profilul era cel în uz în acel spațiu de lucru, spațiul de lucru revine la profilul lui principal.
  • unarchive_account_profile readuce un profil arhivat. Se numără din nou la limita planului, așa că un spațiu de lucru plin îl refuză. Un profil care a venit cu o distribuire de echipă nu poate fi restaurat astfel.
  • delete_account_profile șterge definitiv un profil arhivat și, odată cu el, conversațiile atașate de el. Primește doar un profil arhivat: arhivează mai întâi, apoi șterge.
Ștergerea nu poate fi anulată

Un profil șters cu delete_account_profile a dispărut, la fel și conversațiile atașate lui. Arhivarea este pasul de folosit când vrei doar să scoți un profil din cale.

Setează cărui profil aparține un element

update_entity_account_profiles primește _id-ul elementului și o listă account_profiles nevidă și setează cărui profil aparține acel element. Funcționează pe un contact, o conversație, un asistent AI, un agent AI și o mini aplicație și refuză orice alt tip de element.

Linia telefonică a unui profil

Trei metode ale Telefonului primesc un profil. Sunt listate împreună cu restul metodelor Telefonului, iar un profil este modul în care își găsesc numărul.

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026