Naar de inhoud springen

Profielen

De gezichten die jij en je bedrijf laten zien.

Profielen openen
Gecontroleerd aan de hand van het dashboard op 20 november 2026

Profielen heeft zes publieke methoden voor de profielen zelf: tonen, maken, wijzigen, archiveren, terugzetten en verwijderen. Een extra methode stelt in bij welke profielen een item hoort, en drie horen bij Telefoon en gaan over de antwoordregels en de zakelijke identiteit van een profiel. Elke methode werkt voor het account waarvan je de API-sleutel gebruikt.

Een abonnement voor Profielen kiezen, een lid uitnodigen, de assistent van een profiel kiezen en een nummer koppelen hebben op dit moment geen publieke methode. Die doe je in het dashboard.

Stuur een verzoek naar een methode met je sleutel:

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

Een geweigerd verzoek antwoordt met een negatieve code en zegt in data waarom. Elke methode neemt ook een optionele workspace_id, om te werken in een werkruimte die je bezit, anders dan je hoofdwerkruimte.

Profielen lezen

get_account_profiles toont de profielen van de werkruimte, het laatst gewijzigde eerst.

  • _id of profile_id geeft een profiel.
  • filter_type beperkt de lijst: archived voor gearchiveerde profielen, shared voor profielen die met jou zijn gedeeld, favorites voor de profielen die met het hartje zijn gemarkeerd. Weggelaten toont hij elk actief profiel.
  • account_type beperkt op soort: personal, business of virtual.
  • folder_id toont een dashboardmap, of __none__ voor de profielen in geen enkele map. search, limit, skip en bookmark pagineren en doorzoeken de lijst.

Een profiel maken

create_account_profile neemt een profile_name en een account_type, en optioneel een profile_signature (de beschrijving), een afbeelding en een avatar, en een email_account_id om een gekoppelde mailbox te koppelen.

  • Een virtueel profiel neemt ook virtual_character, de beschrijving waaruit zijn portret wordt getekend, en virtual_traits, een keuze voor elk van leeftijd, geslacht, etniciteit en uiterlijk. Het wordt geweigerd tenzij het abonnement Profielen van de werkruimte virtuele profielen bevat (Starter en hoger) of het account een betaald lidmaatschap heeft, en het account is geverifieerd.
  • Een persoonlijk profiel van een persoonlijk account, of een zakelijk profiel van een zakelijk account, begint met de eigen afbeelding en avatar van het account als je er geen stuurt.
  • Een werkruimte die al evenveel profielen heeft als het abonnement toestaat, weigert een nieuw met code -62 en reason plan_cap. Ze houdt de profielen die ze heeft. Het hoofdprofiel waarmee een account of werkruimte begint, wordt nooit geweigerd.

Een profiel wijzigen

update_account_profile neemt de _id van het profiel en elk van de velden die je wilt wijzigen: de naam, de beschrijving, de afbeelding en avatar, email_account_id, account_type, het virtuele personage en de eigenschappen, en registered_apps en registered_mini_apps, die bepalen welke modules een tabblad krijgen bij elk contact in het profiel (registered_apps is de hele geordende lijst).

  • Een profiel omzetten naar virtueel vraagt dezelfde eisen als er een maken.
  • Een profiel dat met jou is gedeeld, is een kopie: zijn eigenaar richt zijn canvas in, dus een wijziging van canvas erop wordt geweigerd.

Archiveren, terugzetten en verwijderen

  • archive_account_profile neemt profile_id en verplaatst het profiel naar Gearchiveerd. Het hoofdprofiel wordt geweigerd. Als het profiel het profiel in gebruik in die werkruimte was, gaat de werkruimte terug naar zijn hoofdprofiel.
  • unarchive_account_profile haalt een gearchiveerd profiel terug. Het telt weer mee voor de limiet van het abonnement, dus een volle werkruimte weigert het. Een profiel dat met een teamdeling kwam, kan op deze manier niet worden teruggezet.
  • delete_account_profile verwijdert een gearchiveerd profiel definitief, en de chats die eraan hangen met hem. Hij neemt alleen een gearchiveerd profiel: eerst archiveren, dan verwijderen.
Verwijderen kan niet ongedaan worden gemaakt

Een profiel dat met delete_account_profile is verwijderd, is weg, en de chats die eraan vastzitten ook. Archiveren is de stap om te gebruiken als je een profiel alleen uit de weg wilt hebben.

Instellen bij welke profielen een item hoort

update_entity_account_profiles neemt de _id van het item en een niet-lege lijst account_profiles, en stelt in bij welke profielen dat item hoort. Het werkt op een contact, een chat, een AI-assistent, een AI-agent en een mini-app, en weigert elke andere soort item.

De telefoonlijn van een profiel

Drie methoden van Telefoon nemen een profiel. Ze staan bij de andere methoden van Telefoon, en een profiel is hoe ze zijn nummer vinden.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026