Preskočiť na obsah

Profily

Tváre, ktoré vy a vaša firma ukazujete.

Otvoriť Profily
Overené voči nástenke dňa 20. novembra 2026

Profily majú šesť verejných metód pre samotné profily: výpis, vytvorenie, zmena, archivácia, obnovenie a odstránenie. Ešte jedna nastavuje, ku ktorým profilom položka patrí, a tri patria Telefónu a pokrývajú pravidlá odpovedania profilu a jeho firemnú identitu. Každá koná za účet, ktorého API kľúč použijete.

Výber plánu Profilov, pozvanie člena, výber asistenta profilu a pripojenie čísla dnes nemajú verejnú metódu. Robia sa v dashboarde.

Pošlite požiadavku metóde so svojím kľúčom:

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

Odmietnutá požiadavka odpovie záporným code a dôvod uvedie v data. Každá metóda berie aj voliteľné workspace_id, aby konala v pracovnom priestore, ktorý vlastníte, inom než vo vašom domovskom.

Čítanie profilov

get_account_profiles vypíše profily pracovného priestoru, naposledy zmenené ako prvé.

  • _id alebo profile_id vráti jeden profil.
  • filter_type zužuje zoznam: archived pre archivované profily, shared pre profily zdieľané s vami, favorites pre tie označené srdcom. Ak sa vynechá, vypíše každý aktívny profil.
  • account_type zužuje podľa druhu: personal, business alebo virtual.
  • folder_id vypíše jeden priečinok dashboardu, alebo __none__ pre profily bez priečinka. search, limit, skip a bookmark stránkujú a prehľadávajú zoznam.

Vytvorenie profilu

create_account_profile berie profile_name a account_type a voliteľne profile_signature (popis), obrázok a avatara a email_account_id na pripojenie pripojenej schránky.

  • Virtuálny profil berie aj virtual_character, popis, z ktorého sa kreslí jeho portrét, a virtual_traits, po jednej voľbe pre vek, pohlavie, etnikum a vzhľad. Odmietne sa, ak plán Profilov pracovného priestoru nezahŕňa virtuálne profily (Starter a vyššie) alebo účet nemá platené členstvo, a účet musí byť overený.
  • Osobný profil osobného účtu alebo firemný profil firemného účtu začína s vlastným obrázkom a avatarom účtu, ak žiadne nepošlete.
  • Pracovný priestor, ktorý už obsahuje toľko profilov, koľko jeho plán povoľuje, odmietne nový s code -62 a reason plan_cap. Ponechá si profily, ktoré má. Hlavný profil, s ktorým účet alebo pracovný priestor začína, sa nikdy neodmietne.

Zmena profilu

update_account_profile berie _id profilu a ľubovoľné polia, ktoré chcete zmeniť: meno, popis, obrázok a avatara, email_account_id, account_type, virtuálnu postavu a vlastnosti a registered_apps a registered_mini_apps, ktoré rozhodujú o moduloch, ktoré dostanú kartu pri každom kontakte v profile (registered_apps je celý usporiadaný zoznam).

  • Prepnutie profilu na virtuálny musí splniť rovnakú podmienku ako jeho vytvorenie.
  • Profil, ktorý bol s vami zdieľaný, je kópia: jeho plochu usporadúva jeho vlastník, takže zmena canvas na ňom sa odmietne.

Archivácia, obnovenie a odstránenie

  • archive_account_profile berie profile_id a presunie profil do Archivované. Hlavný profil sa odmietne. Ak bol profil tým, ktorý sa v tom pracovnom priestore používal, pracovný priestor sa vráti na svoj hlavný profil.
  • unarchive_account_profile vráti archivovaný profil. Znova sa počíta do limitu plánu, takže plný pracovný priestor ho odmietne. Profil, ktorý prišiel s tímovým zdieľaním, sa takto obnoviť nedá.
  • delete_account_profile odstráni archivovaný profil natrvalo a spolu s ním chaty, ktoré na ňom visia. Berie iba archivovaný profil: najprv archivujte, potom odstráňte.
Odstránenie sa nedá vrátiť späť

Profil odstránený cez delete_account_profile je preč a rovnako chaty k nemu pripojené. Archivácia je krok, ktorý použite, keď chcete profil len dať z cesty.

Nastavenie, ku ktorým profilom položka patrí

update_entity_account_profiles berie _id položky a neprázdny zoznam account_profiles a nastaví, ku ktorým profilom táto položka patrí. Funguje na kontakte, chate, AI asistentovi, AI agentovi a mini aplikácii a každý iný druh položky odmietne.

Telefónna linka profilu

Tri metódy Telefónu berú profil. Sú uvedené spolu s ostatnými metódami Telefónu a profil je spôsob, ako nájdu jeho číslo.

Aký je tento návod?

Naposledy aktualizované dňa 20. novembra 2026