Hoppa till innehållet

Profiler

Ansiktena du och ditt företag visar upp.

Öppna Profiler
Kontrollerad mot instrumentpanelen den 20 november 2026

Profiler har sex offentliga metoder för själva profilerna: lista, skapa, ändra, arkivera, återställa och ta bort. En till anger vilka profiler ett objekt hör till, och tre hör till Telefon och gäller en profils svarsregler och företagsidentitet. Varje metod verkar för kontot vars API-nyckel du använder.

Att välja en Profiler-plan, bjuda in en medlem, välja en profils assistent och koppla ett nummer har ingen offentlig metod i dag. Det görs i dashboarden.

Skicka en förfrågan till en metod med din nyckel:

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 nekad förfrågan svarar med en negativ code och säger varför i data. Varje metod tar också ett valfritt workspace_id, för att verka i en arbetsyta du äger utöver din hemarbetsyta.

Läs profiler

get_account_profiles listar arbetsytans profiler, senast ändrade först.

  • _id eller profile_id returnerar en profil.
  • filter_type smalnar av listan: archived för arkiverade profiler, shared för profiler som delats med dig, favorites för de som markerats med hjärtat. Utelämnat listar det varje aktiv profil.
  • account_type smalnar av efter sort: personal, business eller virtual.
  • folder_id listar en dashboardmapp, eller __none__ för profilerna som inte ligger i någon mapp. search, limit, skip och bookmark bläddrar i och söker i listan.

Skapa en profil

create_account_profile tar ett profile_name och ett account_type, och valfritt en profile_signature (beskrivningen), en bild och en avatar, och ett email_account_id för att koppla en ansluten brevlåda.

  • En virtuell profil tar också virtual_character, beskrivningen som dess porträtt ritas utifrån, och virtual_traits, ett val vardera för ålder, kön, etnicitet och utseende. Den nekas om inte arbetsytans Profiler-plan inkluderar virtuella profiler (Starter och uppåt) eller kontot har ett betalt medlemskap, och kontot har verifierats.
  • En personlig profil för ett personligt konto, eller en företagsprofil för ett företagskonto, börjar med kontots egen bild och avatar när du inte skickar någon.
  • En arbetsyta som redan har lika många profiler som dess plan tillåter nekar en ny med code -62 och reason plan_cap. Den behåller profilerna den har. Huvudprofilen som ett konto eller en arbetsyta börjar med nekas aldrig.

Ändra en profil

update_account_profile tar profilens _id och vilka fält du vill ändra: namnet, beskrivningen, bilden och avataren, email_account_id, account_type, den virtuella karaktären och dragen, samt registered_apps och registered_mini_apps, som avgör vilka moduler som får en flik på varje kontakt i profilen (registered_apps är hela den ordnade listan).

  • Att byta en profil till virtuell måste klara samma krav som att skapa en.
  • En profil som delats med dig är en kopia: dess ägare ordnar dess canvas, så en ändring av canvas på den nekas.

Arkivera, återställa och ta bort

  • archive_account_profile tar profile_id och flyttar profilen till Arkiverad. Huvudprofilen nekas. Om profilen var den som användes i den arbetsytan går arbetsytan tillbaka till sin huvudprofil.
  • unarchive_account_profile tar tillbaka en arkiverad profil. Den räknas mot planens gräns igen, så en full arbetsyta nekar det. En profil som kom med en teamdelning kan inte återställas på det här sättet.
  • delete_account_profile tar bort en arkiverad profil för gott, och chattarna som hänger på den med den. Den tar bara en arkiverad profil: arkivera först, ta sedan bort.
Borttagning kan inte ångras

En profil som tagits bort med delete_account_profile är borta, och chattarna som hör till den likaså. Arkivera är steget att använda när du bara vill ha en profil ur vägen.

Ange vilka profiler ett objekt hör till

update_entity_account_profiles tar objektets _id och en icke-tom account_profiles-lista, och anger vilka profiler objektet hör till. Den fungerar på en kontakt, en chatt, en AI-assistent, en AI-agent och en miniapp, och nekar alla andra sorters objekt.

En profils telefonlinje

Tre av Telefons metoder tar en profil. De listas tillsammans med Telefons övriga metoder, och en profil är hur de hittar dess nummer.

Hur är den här guiden?

Senast uppdaterad den 19 november 2026