Ziyaretçi Kaydı

POST /register

Ziyaretçiyi kaydeder veya günceller ve sohbet oturumu için JWT (accessToken) döner. JWT gerekmez.

İstek

POST /register HTTP/1.1
Host: widget-api.chatbot.aithinks.net
Content-Type: application/json

{
  "appId": "550e8400-e29b-41d4-a716-446655440000",
  "firstName": "Ali",
  "lastName": "Yılmaz",
  "email": "ali@example.com",
  "phone": "905551112233",
  "userId": "external-user-123"
}

const { accessToken } = await fetch(`${BASE_URL}/register`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    appId: APP_ID,
    firstName: 'Ali',
    lastName: 'Yılmaz',
    email: 'ali@example.com',
  }),
}).then((r) => r.json());

Body alanları

Alan	Kurallar
appId	Zorunlu, UUID
firstName	Opsiyonel, string
lastName	Opsiyonel, string
email	Opsiyonel; geçerli e-posta. phone ve userId yoksa zorunlu
phone	Opsiyonel; yalnızca rakam, 11–12 karakter. email ve userId yoksa zorunlu
userId	Opsiyonel; harici kullanıcı kimliği. email ve phone yoksa zorunlu

Kimlik için email, phone veya userId alanlarından en az biri gönderilmelidir.

Widget Ayarları içindeki requiredFields listesinde yer alan alanlar da body'de bulunmalıdır; aksi halde istek reddedilir.

Başarılı yanıt

{
  "accessToken": "<jwt>"
}

Bu token'ı Mesaj Geçmişi, Mesaj Gönderme ve Gerçek zamanlı mesajlar bağlantısında kullanın.

Hatalar

Durum	Anlamı
400	Validasyon hatası veya eksik zorunlu alanlar (Missing required fields: ...)
404	Chat uygulaması yok veya widget provider'ı desteklemiyor