Przejdź do treści

Profile

Twarze, które pokazujesz Ty i Twoja firma.

Otwórz Profile
Sprawdzono z pulpitem dnia 20 listopada 2026

Profile mają sześć metod publicznych dla samych profili: wyświetlanie, tworzenie, zmiana, archiwizowanie, przywracanie i usuwanie. Jedna kolejna ustawia, do których profili należy element, a trzy należą do Telefonu i dotyczą zasad odbierania i tożsamości firmowej profilu. Każda działa dla konta, którego klucza API używasz.

Wybór planu Profili, zaproszenie członka, wybór asystenta profilu i przypisanie numeru nie mają dziś metody publicznej. Te rzeczy robi się w dashboardzie.

Wyślij żądanie do metody ze swoim kluczem:

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

Odrzucone żądanie odpowiada ujemnym code i w data mówi dlaczego. Każda metoda przyjmuje też opcjonalne workspace_id, by działać w przestrzeni roboczej, którą posiadasz, innej niż domowa.

Odczyt profili

get_account_profiles wyświetla profile przestrzeni roboczej, od ostatnio zmienionych.

  • _id lub profile_id zwraca jeden profil.
  • filter_type zawęża listę: archived dla zarchiwizowanych profili, shared dla profili udostępnionych Tobie, favorites dla oznaczonych sercem. Pominięte, wyświetla każdy aktywny profil.
  • account_type zawęża według rodzaju: personal, business lub virtual.
  • folder_id wyświetla jeden folder dashboardu, albo __none__ dla profili bez folderu. search, limit, skip i bookmark stronicują i przeszukują listę.

Tworzenie profilu

create_account_profile przyjmuje profile_name i account_type oraz opcjonalnie profile_signature (opis), obraz i awatar, a także email_account_id, by przypisać połączoną skrzynkę.

  • Profil wirtualny przyjmuje też virtual_character, opis, z którego rysowany jest jego portret, i virtual_traits, po jednym wyborze dla wieku, płci, pochodzenia etnicznego i wyglądu. Jest odrzucany, chyba że plan Profili przestrzeni roboczej obejmuje profile wirtualne (Starter i wyżej) albo konto ma płatne członkostwo, a konto zostało zweryfikowane.
  • Profil osobisty konta osobistego lub profil firmowy konta firmowego zaczyna od własnego obrazu i awatara konta, gdy żadnego nie wyślesz.
  • Przestrzeń robocza, która ma już tyle profili, na ile pozwala jej plan, odrzuca nowy z code -62 i reason plan_cap. Zachowuje profile, które ma. Profil główny, od którego zaczyna konto lub przestrzeń robocza, nigdy nie jest odrzucany.

Zmiana profilu

update_account_profile przyjmuje _id profilu i dowolne z pól, które chcesz zmienić: nazwę, opis, obraz i awatar, email_account_id, account_type, postać wirtualną i cechy oraz registered_apps i registered_mini_apps, które decydują o modułach dostających kartę przy każdym kontakcie w profilu (registered_apps to cała uporządkowana lista).

  • Przełączenie profilu na wirtualny wymaga spełnienia tego samego progu co jego utworzenie.
  • Profil, który został ci udostępniony, jest kopią: jego właściciel układa jego kanwę, więc zmiana canvas na nim jest odrzucana.

Archiwizowanie, przywracanie i usuwanie

  • archive_account_profile przyjmuje profile_id i przenosi profil do Zarchiwizowano. Profil główny jest odrzucany. Jeśli profil był tym używanym w tej przestrzeni roboczej, przestrzeń robocza wraca do swojego profilu głównego.
  • unarchive_account_profile przywraca zarchiwizowany profil. Znów liczy się do limitu planu, więc pełna przestrzeń robocza go odrzuca. Profilu, który przyszedł z udostępnieniem zespołowym, nie można tak przywrócić.
  • delete_account_profile usuwa zarchiwizowany profil na dobre, a razem z nim czaty, które z niego wychodzą. Przyjmuje tylko zarchiwizowany profil: najpierw zarchiwizuj, potem usuń.
Usunięcia nie można cofnąć

Profil usunięty przez delete_account_profile znika, a z nim czaty do niego przypisane. Archiwizowanie to krok, którego użyj, gdy chcesz tylko usunąć profil z drogi.

Ustaw, do których profili należy element

update_entity_account_profiles przyjmuje _id elementu i niepustą listę account_profiles i ustawia, do których profili ten element należy. Działa na kontakcie, czacie, asystencie AI, agencie AI i mini aplikacji, a każdy inny rodzaj elementu odrzuca.

Linia telefoniczna profilu

Trzy metody Telefonu przyjmują profil. Są wyliczone razem z resztą metod Telefonu, a profil to sposób, w jaki znajdują jego numer.

Jak oceniasz ten poradnik?

Ostatnia aktualizacja: 19 listopada 2026