Ugrás a tartalomhoz

Profilok

Az arcok, amelyeket Ön és a vállalkozása mutat.

Profilok megnyitása
Az irányítópulttal összevetve ekkor: 2026. november 20.

A Profiloknak hat nyilvános metódusa van magukra a profilokra: listázás, létrehozás, módosítás, archiválás, visszaállítás és törlés. Még egy azt állítja be, mely profiloké egy elem, három pedig a Telefonhoz tartozik, és egy profil válaszolási szabályait és üzleti identitását fedi le. Mindegyik annak a fióknak a nevében jár el, amelynek az API-kulcsát használja.

A Profilok csomag kiválasztása, tag meghívása, egy profil asszisztensének kiválasztása és szám csatolása ma nem rendelkezik nyilvános metódussal. Ezek a dashboardon történnek.

Küldjön kérést egy metódusnak a kulcsával:

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

Az elutasított kérés negatív code értéket ad, és a data megmondja az okát. Minden metódus fogad egy opcionális workspace_id értéket is, hogy egy Ön által birtokolt, az alapmunkaterületétől eltérő munkaterületen járjon el.

Profilok olvasása

A get_account_profiles listázza a munkaterület profiljait, a legutóbb módosítottal kezdve.

  • Az _id vagy a profile_id egy profilt ad vissza.
  • A filter_type szűkíti a listát: archived az archivált profiloknak, shared az Önnel megosztott profiloknak, favorites a szívvel jelöltöknek. Ha elhagyja, minden aktív profilt listáz.
  • Az account_type fajta szerint szűkít: personal, business vagy virtual.
  • A folder_id egy dashboard-mappát listáz, vagy __none__ a mappa nélküli profilokat. A search, limit, skip és bookmark lapozza és keresi a listát.

Profil létrehozása

A create_account_profile egy profile_name és egy account_type értéket vár, opcionálisan egy profile_signature értéket (a leírás), egy képet és egy avatart, és egy email_account_id értéket egy csatlakoztatott postafiók csatolásához.

  • A virtuális profil virtual_character értéket is vár, a leírást, amelyből a portréja rajzolódik, és virtual_traits értéket, mindegyik egy választás a korhoz, nemhez, etnikumhoz és megjelenéshez. Elutasítjuk, hacsak a munkaterület Profilok csomagja nem tartalmaz virtuális profilokat (Starter és afölött) vagy a fióknak nincs fizetős tagsága, és a fiókot nem ellenőrizték.
  • A személyes fiók személyes profilja vagy az üzleti fiók üzleti profilja a fiók saját képével és avatarjával indul, ha Ön nem küld egyet sem.
  • Az a munkaterület, amely már annyi profilt tart, amennyit a csomagja megenged, új profilt elutasít code -62 értékkel és plan_cap reason értékkel. Megtartja a meglévő profiljait. A fő profilt, amellyel egy fiók vagy munkaterület indul, soha nem utasítjuk el.

Profil módosítása

Az update_account_profile a profil _id értékét várja, és bármelyik mezőt, amelyet módosítani szeretne: a nevet, a leírást, a képet és az avatart, az email_account_id értéket, az account_type értéket, a virtuális karaktert és jellemzőket, valamint a registered_apps és registered_mini_apps értéket, amelyek azt döntik el, mely modulok kapnak lapot a profil minden kapcsolatán (a registered_apps a teljes rendezett lista).

  • A profil virtuálisra váltása ugyanazt a küszöböt jelenti, mint a létrehozása.
  • Az Önnel megosztott profil egy másolat: a tulajdonosa rendezi a vásznát, ezért a rajta lévő canvas módosítását elutasítjuk.

Archiválás, visszaállítás és törlés

  • Az archive_account_profile a profile_id értéket várja, és az Archiválva közé teszi a profilt. A fő profilt elutasítjuk. Ha a profil az volt, amelyet abban a munkaterületben használtak, a munkaterület visszatér a fő profiljához.
  • Az unarchive_account_profile visszahozza az archivált profilt. Újra beleszámít a csomag korlátjába, ezért a megtelt munkaterület elutasítja. A csapatmegosztással érkezett profil így nem állítható vissza.
  • A delete_account_profile véglegesen töröl egy archivált profilt, és vele a hozzá tartozó csevegéseket. Csak archivált profilt fogad: előbb archiváljon, utána törölje.
A törlés nem vonható vissza

A delete_account_profile metódussal törölt profil elvész, és vele a hozzá csatolt csevegések is. Az Archiválás az a lépés, amelyet akkor használjon, ha csak félre szeretné tenni a profilt.

Annak beállítása, mely profiloké egy elem

Az update_entity_account_profiles az elem _id értékét és egy nem üres account_profiles listát vár, és beállítja, mely profiloké az az elem. Kapcsolaton, csevegésen, AI asszisztensen, AI-ügynökön és mini alkalmazáson működik, és minden más fajta elemet elutasít.

Egy profil telefonvonala

A Telefon három metódusa fogad profilt. A Telefon többi metódusával együtt vannak felsorolva, és a profil az, amelyen át megtalálják a számát.

  • A get_profile_answering_rules kiolvassa egy vonal válaszolási szabályait (nyitvatartás, csörgetési időkorlát, kit csörgetnek, átirányítás, hangposta és rögzítés), és hogy mit enged az aktuális csomag.
  • Az update_profile_answering_rules elmenti őket. A csomagban nem szereplő beállítást elutasítjuk, nem pedig elhagyjuk.
  • Az update_profile_business_identity eltárolja az üzleti identitást azon a profilon, amely a számot birtokolni fogja.

Milyen ez az útmutató?

Utoljára frissítve: 2026. november 20.