Gå til indhold

Profiler

De ansigter, du og din virksomhed viser.

Åbn Profiler
Kontrolleret mod dashboardet den 20. november 2026

Profiler har seks offentlige metoder til selve profilerne: list, opret, ændr, arkivér, gendan og slet. Én til sætter, hvilke profiler et element hører til, og tre hører til Telefon og dækker en profils svarregler og virksomhedsidentitet. Hver virker for den konto, hvis API-nøgle du bruger.

At vælge en Profiler-plan, invitere et medlem, vælge en profils assistent og knytte et nummer til har ingen offentlig metode i dag. Det gøres i dashboardet.

Send en forespørgsel til en metode med din nøgle:

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

En afvist forespørgsel svarer med en negativ code og siger hvorfor i data. Hver metode tager også et valgfrit workspace_id, for at virke i et arbejdsområde, du ejer, andet end dit hjemlige.

Læs profiler

get_account_profiles lister arbejdsområdets profiler, senest ændrede først.

  • _id eller profile_id returnerer én profil.
  • filter_type indsnævrer listen: archived for arkiverede profiler, shared for profiler delt med dig, favorites for dem, der er markeret med hjertet. Udeladt lister den alle aktive profiler.
  • account_type indsnævrer efter art: personal, business eller virtual.
  • folder_id lister én dashboard-mappe, eller __none__ for profilerne uden mappe. search, limit, skip og bookmark sider og søger i listen.

Opret en profil

create_account_profile tager et profile_name og en account_type og eventuelt en profile_signature (beskrivelsen), et billede og en avatar samt en email_account_id til at knytte en forbundet postkasse.

  • En virtuel profil tager også virtual_character, den beskrivelse, dens portræt tegnes ud fra, og virtual_traits, ét valg hver for alder, køn, etnicitet og udseende. Den afvises, medmindre arbejdsområdets Profiler-plan indeholder virtuelle profiler (Starter og op) eller kontoen har et betalt medlemskab, og kontoen er verificeret.
  • En personlig profil på en personlig konto eller en virksomhedsprofil på en virksomhedskonto starter med kontoens eget billede og avatar, når du ikke sender nogen.
  • Et arbejdsområde, der allerede rummer lige så mange profiler, som dets plan tillader, afviser en ny med code -62 og reason plan_cap. Det beholder de profiler, det har. Den hovedprofil, en konto eller et arbejdsområde starter med, afvises aldrig.

Ændr en profil

update_account_profile tager profilens _id og de felter, du vil ændre: navnet, beskrivelsen, billedet og avataren, email_account_id, account_type, den virtuelle figur og egenskaber samt registered_apps og registered_mini_apps, som afgør de moduler, der får en fane på hver kontakt i profilen (registered_apps er hele den ordnede liste).

  • At skifte en profil til virtuel kræver det samme som at oprette en.
  • En profil, der blev delt med dig, er en kopi: dens ejer arrangerer dens lærred, så en ændring af canvas på den afvises.

Arkivér, gendan og slet

  • archive_account_profile tager profile_id og flytter profilen til Arkiveret. Hovedprofilen afvises. Hvis profilen var den, der var i brug i det arbejdsområde, vender arbejdsområdet tilbage til sin hovedprofil.
  • unarchive_account_profile bringer en arkiveret profil tilbage. Den tæller igen med i planens grænse, så et fuldt arbejdsområde afviser den. En profil, der kom med en teamdeling, kan ikke gendannes på denne måde.
  • delete_account_profile sletter en arkiveret profil for altid og de chats, der hænger på den, med den. Den tager kun en arkiveret profil: arkivér først, slet derefter.
Sletning kan ikke fortrydes

En profil, der er slettet med delete_account_profile, er væk, og det er de chats, der er knyttet til den, også. Arkivér er det trin, du skal bruge, når du bare vil have en profil af vejen.

Indstil, hvilke profiler et element hører til

update_entity_account_profiles tager elementets _id og en ikke-tom account_profiles-liste og sætter, hvilke profiler det element hører til. Den virker på en kontakt, en chat, en AI-assistent, en AI-agent og en miniapp, og afviser enhver anden slags element.

En profils telefonlinje

Tre metoder i Telefon tager en profil. De er listet sammen med resten af Telefons metoder, og en profil er den måde, de finder dens nummer på.

Hvordan er denne guide?

Sidst opdateret den 19. november 2026