İçeriğe geç

Profiller

Sizin ve işletmenizin gösterdiği yüzler.

Profiller aç
20 Kasım 2026 tarihinde kontrol paneliyle karşılaştırıldı

Profillerin, profillerin kendisi için altı herkese açık yöntemi vardır: listeleme, oluşturma, değiştirme, arşivleme, geri getirme ve silme. Bir yöntem daha, bir öğenin hangi profillere ait olduğunu ayarlar ve üçü Telefon'a aittir ve bir profilin yanıtlama kurallarını ve işletme kimliğini kapsar. Her biri, API anahtarını kullandığınız hesap adına çalışır.

Bir Profiller planı seçme, üye davet etme, bir profilin asistanını seçme ve numara bağlama için bugün herkese açık bir yöntem yoktur. Bunlar dashboard'da yapılır.

Anahtarınızla bir yönteme istek gönderin:

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

Reddedilen bir istek negatif bir code yanıtlar ve nedenini data içinde söyler. Her yöntem ayrıca, ana çalışma alanınızdan başka sahibi olduğunuz bir çalışma alanında işlem yapmak için isteğe bağlı bir workspace_id alır.

Profilleri okuma

get_account_profiles, çalışma alanının profillerini en son değişen başta olmak üzere listeler.

  • _id veya profile_id tek bir profil döndürür.
  • filter_type listeyi daraltır: arşivlenmiş profiller için archived, sizinle paylaşılan profiller için shared, kalple işaretlenenler için favorites. Verilmezse her etkin profili listeler.
  • account_type türe göre daraltır: personal, business veya virtual.
  • folder_id bir dashboard klasörünü listeler ya da hiçbir klasörde olmayan profiller için __none__. search, limit, skip ve bookmark listeyi sayfalar ve arar.

Bir profil oluşturma

create_account_profile, bir profile_name ve bir account_type alır; isteğe bağlı olarak bir profile_signature (açıklama), bir resim ve bir avatar ile bağlı bir posta kutusunu eklemek için bir email_account_id alır.

  • Sanal bir profil ayrıca, portresinin çizildiği açıklama olan virtual_character ve yaş, cinsiyet, etnik köken ve görünüm için birer seçim olan virtual_traits alır. Çalışma alanının Profiller planı sanal profilleri içermedikçe (Starter ve üstü) veya hesabın ücretli bir üyeliği olmadıkça ve hesap doğrulanmadıkça reddedilir.
  • Kişisel bir hesabın kişisel profili veya işletme hesabının işletme profili, siz hiçbir şey göndermediğinizde hesabın kendi resmi ve avatarıyla başlar.
  • Planının izin verdiği kadar profili olan bir çalışma alanı, yeni birini code -62 ve reason plan_cap ile reddeder. Sahip olduğu profilleri korur. Bir hesabın veya çalışma alanının başladığı ana profil hiçbir zaman reddedilmez.

Bir profili değiştirme

update_account_profile, profilin _id değerini ve değiştirmek istediğiniz alanlardan herhangi birini alır: ad, açıklama, resim ve avatar, email_account_id, account_type, sanal karakter ve özellikler ile profildeki her kişide hangi modüllerin sekme alacağına karar veren registered_apps ve registered_mini_apps (registered_apps sıralı listenin tamamıdır).

  • Bir profili sanal yapmak, oluşturmakla aynı eşiği geçmeyi gerektirir.
  • Sizinle paylaşılan bir profil bir kopyadır: tuvalini sahibi düzenler; bu yüzden üzerinde canvas değişikliği reddedilir.

Arşivleme, geri getirme ve silme

  • archive_account_profile, profile_id alır ve profili Arşivlendi'ye taşır. Ana profil reddedilir. Profil o çalışma alanında kullanımda olan profilse çalışma alanı ana profiline döner.
  • unarchive_account_profile, arşivlenmiş bir profili geri getirir. Planın sınırına yeniden sayılır; bu yüzden dolu bir çalışma alanı bunu reddeder. Bir ekip paylaşımıyla gelen bir profil bu yolla geri getirilemez.
  • delete_account_profile, arşivlenmiş bir profili ve ona bağlı sohbetleri kalıcı olarak siler. Yalnızca arşivlenmiş bir profili kabul eder: önce arşivleyin, sonra silin.
Silme geri alınamaz

delete_account_profile ile silinen bir profil gider, ona bağlı sohbetler de. Bir profili yalnızca yoldan çekmek istiyorsanız kullanılacak adım arşivlemektir.

Bir öğenin hangi profillere ait olduğunu ayarlama

update_entity_account_profiles, öğenin _id değerini ve boş olmayan bir account_profiles listesini alır ve o öğenin hangi profillere ait olduğunu ayarlar. Bir kişi, bir sohbet, bir AI asistanı, bir AI ajanı ve bir mini uygulama üzerinde çalışır ve başka her türden öğeyi reddeder.

Bir profilin telefon hattı

Telefon'un üç yöntemi bir profil alır. Telefon'un diğer yöntemleriyle birlikte listelenirler ve bir profil, numarasını bulmalarının yoludur.

Bu kılavuz nasıl?

Son güncelleme: 19 Kasım 2026