Siirry sisältöön

Profiilit

Kasvot, jotka sinä ja yrityksesi näytätte.

Avaa Profiilit
Tarkistettu koontinäyttöä vasten 20. marraskuuta 2026

Profiileilla on kuusi julkista metodia itse profiileille: listaa, tee, muuta, arkistoi, palauta ja poista. Yksi lisää asettaa, mihin profiileihin kohde kuuluu, ja kolme kuuluu Puhelimelle ja kattaa profiilin vastaussäännöt ja yritysidentiteetin. Jokainen toimii sen tilin puolesta, jonka API-avainta käytät.

Profiilipaketin valinta, jäsenen kutsuminen, profiilin avustajan valinta ja numeron liittäminen eivät tällä hetkellä ole julkisia metodeja. Ne tehdään kojelaudassa.

Lähetä pyyntö metodille avaimellasi:

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

Evätyn pyynnön code on negatiivinen, ja data kertoo syyn. Jokainen metodi ottaa myös valinnaisen workspace_id-kentän, jolla toimit omistamassasi työtilassa, joka ei ole kotityötilasi.

Lue profiileja

get_account_profiles listaa työtilan profiilit, viimeksi muutettu ensin.

  • _id tai profile_id palauttaa yhden profiilin.
  • filter_type rajaa listaa: archived arkistoiduille profiileille, shared sinulle jaetuille profiileille, favorites sydämellä merkityille. Jos se jätetään pois, se listaa jokaisen aktiivisen profiilin.
  • account_type rajaa lajin mukaan: personal, business tai virtual.
  • folder_id listaa yhden kojelaudan kansion tai __none__ profiilit, jotka eivät ole missään kansiossa. search, limit, skip ja bookmark sivuttavat ja hakevat listaa.

Tee profiili

create_account_profile ottaa profile_name- ja account_type-kentät ja valinnaisesti profile_signature-kentän (kuvaus), kuvan ja avatarin sekä email_account_id-kentän yhdistetyn postilaatikon liittämiseksi.

  • Virtuaalinen profiili ottaa myös virtual_character-kentän, kuvauksen, josta sen muotokuva piirretään, ja virtual_traits-kentän, yhden valinnan kullekin: ikä, sukupuoli, etnisyys ja ulkonäkö. Se evätään, ellei työtilan Profiilit-paketti sisällä virtuaalisia profiileja (Starter ja ylöspäin) tai tilillä ole maksullista jäsenyyttä, ja tili on vahvistettu.
  • Henkilökohtaisen tilin henkilökohtainen profiili tai yritystilin yritysprofiili alkaa tilin oman kuvan ja avatarin kanssa, kun et lähetä mitään.
  • Työtila, jossa on jo yhtä monta profiilia kuin sen paketti sallii, evää uuden vastauksella code -62 ja reason plan_cap. Se pitää profiilit, jotka sillä on. Pääprofiilia, jolla tili tai työtila alkaa, ei koskaan evätä.

Muuta profiilia

update_account_profile ottaa profiilin _id-kentän ja minkä tahansa kentistä, jotka haluat muuttaa: nimi, kuvaus, kuva ja avatar, email_account_id, account_type, virtuaalinen hahmo ja piirteet sekä registered_apps ja registered_mini_apps, jotka päättävät moduulit, jotka saavat välilehden jokaiselle profiilin yhteystiedolle (registered_apps on koko järjestetty lista).

  • Profiilin vaihtaminen virtuaaliseksi ylittää saman esteen kuin sellaisen tekeminen.
  • Sinulle jaettu profiili on kopio: sen omistaja järjestää sen kankaan, joten canvas-kentän muutos siihen evätään.

Arkistoi, palauta ja poista

  • archive_account_profile ottaa profile_id-kentän ja siirtää profiilin kohtaan Arkistoitu. Pääprofiili evätään. Jos profiili oli kyseisessä työtilassa käytössä oleva, työtila palaa pääprofiiliinsa.
  • unarchive_account_profile tuo arkistoidun profiilin takaisin. Se lasketaan taas paketin rajaan, joten täysi työtila evää sen. Tiimijaon mukana tullutta profiilia ei voi palauttaa tällä tavalla.
  • delete_account_profile poistaa arkistoidun profiilin lopullisesti ja siihen kuuluvat keskustelut mukanaan. Se ottaa vain arkistoidun profiilin: arkistoi ensin, poista sitten.
Poistoa ei voi perua

Profiili, joka poistetaan metodilla delete_account_profile, on poissa, ja niin ovat siihen liitetyt keskustelutkin. Arkistointi on askel, jota käytät, kun haluat vain saada profiilin pois tieltä.

Aseta, mihin profiileihin kohde kuuluu

update_entity_account_profiles ottaa kohteen _id-kentän ja ei-tyhjän account_profiles-listan ja asettaa, mihin profiileihin kyseinen kohde kuuluu. Se toimii yhteystiedolle, chatille, tekoälyavustajalle, tekoälyagentille ja mini-sovellukselle, ja evää minkä tahansa muun lajin kohteen.

Profiilin puhelinlinja

Kolme Puhelimen metodia ottaa profiilin. Ne on listattu Puhelimen muiden metodien kanssa, ja profiili on tapa, jolla ne löytävät sen numeron.

Millainen tämä opas on?

Päivitetty viimeksi 19. marraskuuta 2026