Hopp til innholdet

Profiler

Ansiktene du og bedriften din viser.

Åpne Profiler
Kontrollert mot oversiktspanelet 20. november 2026

Profiler har seks offentlige metoder for selve profilene: list, lag, endre, arkiver, gjenopprett og slett. Én til setter hvilke profiler et element tilhører, og tre hører til Telefon og dekker en profils svarregler og forretningsidentitet. Hver virker for kontoen hvis API-nøkkel du bruker.

Å velge en Profiler-plan, invitere et medlem, velge en profils assistent og knytte til et nummer har ingen offentlig metode i dag. Det gjøres i dashbordet.

Send en forespørsel til en metode med nøkkelen din:

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 avslått forespørsel svarer en negativ code og sier hvorfor i data. Hver metode tar også en valgfri workspace_id, for å virke i et arbeidsområde du eier, annet enn hjemmeområdet ditt.

Les profiler

get_account_profiles lister arbeidsområdets profiler, de sist endrede først.

  • _id eller profile_id returnerer én profil.
  • filter_type snevrer inn listen: archived for arkiverte profiler, shared for profiler delt med deg, favorites for dem merket med hjertet. Utelatt lister den alle aktive profiler.
  • account_type snevrer inn etter type: personal, business eller virtual.
  • folder_id lister én dashbordmappe, eller __none__ for profilene uten mappe. search, limit, skip og bookmark blar og søker i listen.

Lag en profil

create_account_profile tar et profile_name og en account_type, og eventuelt en profile_signature (beskrivelsen), et bilde og en avatar, og en email_account_id for å knytte til en tilkoblet postboks.

  • En virtuell profil tar også virtual_character, beskrivelsen portrettet tegnes ut fra, og virtual_traits, ett valg hver for alder, kjønn, etnisitet og utseende. Den avslås med mindre arbeidsområdets Profiler-plan inkluderer virtuelle profiler (Starter og oppover) eller kontoen har et betalt medlemskap, og kontoen er verifisert.
  • En personlig profil på en personlig konto, eller en bedriftsprofil på en bedriftskonto, starter med kontoens eget bilde og avatar når du ikke sender noen.
  • Et arbeidsområde som allerede har så mange profiler som planen tillater, avslår en ny med code -62 og reason plan_cap. Det beholder profilene det har. Hovedprofilen en konto eller et arbeidsområde starter med, avslås aldri.

Endre en profil

update_account_profile tar profilens _id og de feltene du vil endre: navnet, beskrivelsen, bildet og avataren, email_account_id, account_type, den virtuelle figuren og egenskapene, og registered_apps og registered_mini_apps, som avgjør modulene som får en fane på hver kontakt i profilen (registered_apps er hele den ordnede listen).

  • Å bytte en profil til virtuell må forbi samme sperre som å lage en.
  • En profil som er delt med deg, er en kopi: eieren ordner lerretet, så en endring av canvas på den avslås.

Arkiver, gjenopprett og slett

  • archive_account_profile tar profile_id og flytter profilen til Arkivert. Hovedprofilen avslås. Hvis profilen var den som var i bruk i det arbeidsområdet, går arbeidsområdet tilbake til hovedprofilen.
  • unarchive_account_profile henter en arkivert profil tilbake. Den teller mot planens grense igjen, så et fullt arbeidsområde avslår den. En profil som kom med en teamdeling, kan ikke gjenopprettes på denne måten.
  • delete_account_profile sletter en arkivert profil for godt, og samtalene som henger på den sammen med den. Den tar bare en arkivert profil: arkiver først, og slett så.
Sletting kan ikke angres

En profil slettet med delete_account_profile er borte, og det er samtalene knyttet til den også. Arkiver er trinnet å bruke når du bare vil ha en profil ut av veien.

Sett hvilke profiler et element tilhører

update_entity_account_profiles tar elementets _id og en ikke-tom account_profiles-liste, og setter hvilke profiler elementet tilhører. Den virker på en kontakt, en samtale, en AI-assistent, en AI-agent og en miniapp, og avslår alle andre typer elementer.

En profils telefonlinje

Tre metoder i Telefon tar en profil. De er listet sammen med resten av Telefons metoder, og en profil er måten de finner nummeret på.

Hvordan er denne veiledningen?

Sist oppdatert 19. november 2026