Přeskočit na obsah

Profily

Tváře, které ukazujete vy a vaše firma.

Otevřít Profily
Ověřeno podle nástěnky dne 20. listopadu 2026

Profily mají šest veřejných metod pro samotné profily: výpis, vytvoření, změnu, archivaci, obnovení a smazání. Jedna další nastavuje, kterým profilům položka patří, a tři patří Telefonu a týkají se pravidel odpovídání profilu a firemní identity. Každá jedná za účet, jehož klíč API použijete.

Volba tarifu Profilů, pozvání člena, volba asistenta profilu a připojení čísla dnes nemají veřejnou metodu. Ty se dělají v dashboardu.

Pošlete požadavek metodě se svým klíčem:

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

Odmítnutý požadavek odpoví záporným code a v data říká proč. Každá metoda bere také volitelné workspace_id, aby jednala v jiném pracovním prostoru, který vlastníte, než ve svém domovském.

Čtení profilů

get_account_profiles vypisuje profily pracovního prostoru, naposledy změněné první.

  • _id nebo profile_id vrátí jeden profil.
  • filter_type zužuje seznam: archived pro archivované profily, shared pro profily sdílené s vámi, favorites pro ty označené srdcem. Když chybí, vypíše každý aktivní profil.
  • account_type zužuje podle druhu: personal, business nebo virtual.
  • folder_id vypíše jednu složku dashboardu, nebo __none__ pro profily bez složky. search, limit, skip a bookmark stránkují a prohledávají seznam.

Vytvoření profilu

create_account_profile bere profile_name a account_type a volitelně profile_signature (popis), obrázek a avatar a email_account_id pro připojení připojené schránky.

  • Virtuální profil bere také virtual_character, popis, podle kterého se kreslí jeho portrét, a virtual_traits, po jedné volbě pro věk, pohlaví, etnický původ a vzhled. Odmítne se, pokud tarif Profilů pracovního prostoru nezahrnuje virtuální profily (Starter a výše) nebo účet nemá placené členství, a účet musí být ověřen.
  • Osobní profil osobního účtu nebo firemní profil firemního účtu začíná vlastním obrázkem a avatarem účtu, když žádné nepošlete.
  • Pracovní prostor, který už drží tolik profilů, kolik jeho tarif povoluje, nový odmítne s code -62 a reason plan_cap. Ponechá si profily, které má. Hlavní profil, kterým účet nebo pracovní prostor začíná, se nikdy neodmítne.

Změna profilu

update_account_profile bere _id profilu a libovolná pole, která chcete změnit: jméno, popis, obrázek a avatar, email_account_id, account_type, virtuální postavu a vlastnosti a registered_apps a registered_mini_apps, které rozhodují o modulech, které dostanou kartu na každém kontaktu v profilu (registered_apps je celý uspořádaný seznam).

  • Přepnutí profilu na virtuální musí splnit stejnou laťku jako jeho vytvoření.
  • Profil, který byl sdílen s vámi, je kopie: jeho plochu uspořádává jeho vlastník, takže změna canvas na něm se odmítne.

Archivace, obnovení a smazání

  • archive_account_profile bere profile_id a přesune profil do Archivováno. Hlavní profil se odmítne. Pokud byl profil tím, který se v onom pracovním prostoru používal, pracovní prostor se vrátí k hlavnímu profilu.
  • unarchive_account_profile vrátí archivovaný profil. Znovu se počítá do limitu tarifu, takže plný pracovní prostor jej odmítne. Profil, který přišel s týmovým sdílením, nelze tímto způsobem obnovit.
  • delete_account_profile smaže archivovaný profil navždy a spolu s ním chaty, které na něm visí. Bere jen archivovaný profil: nejdřív archivujte, pak smažte.
Smazání nelze vrátit zpět

Profil smazaný pomocí delete_account_profile je pryč a také chaty k němu připojené. Archivace je krok, který použijte, když chcete profil jen odklidit.

Nastavení, kterým profilům položka patří

update_entity_account_profiles bere _id položky a neprázdný seznam account_profiles a nastavuje, kterým profilům tato položka patří. Funguje na kontaktu, chatu, AI asistentovi, AI agentovi a mini aplikaci a jakýkoli jiný druh položky odmítne.

Telefonní linka profilu

Tři metody Telefonu berou profil. Jsou vypsány spolu s ostatními metodami Telefonu a profil je způsob, jak najdou jeho číslo.

Jaký je tento průvodce?

Naposledy aktualizováno 19. listopadu 2026