Mesaj Tipleri

Platformdaki mesajlar ortak bir type + data yapısı kullanır. Aynı şemalar Widget API (geçmiş, realtime) ve Client API (mesaj gönderme) tarafında geçerlidir.

Ortak üst yapı

Widget API geçmiş / Socket.IO kayıtlarında mesaj şu üst yapıdadır:

{
  "id": "97b56d6f-41d9-4037-ba2f-4d716ee284e0",
  "createdAt": "2026-08-03T14:53:05.874Z",
  "type": "TEXT",
  "nameOfSender": "Jane Doe",
  "isFromSupport": false,
  "data": {}
}

Alan	Tip	Açıklama
id	string	Mesaj kimliği
createdAt	string	ISO 8601 zaman damgası
type	string	Aşağıdaki enum değerlerinden biri
data	object	Tipe özgü payload
nameOfSender	string	Gönderenin görünen adı
isFromSupport	boolean	true: bot / agent · false: ziyaretçi

Client API POST /message/send isteğinde yalnızca type ve data gönderilir (chatId ile birlikte); üst yapıdaki diğer alanlar sunucu tarafından üretilir.

Desteklenen tipler

Tip	Kullanım	Doküman	Client API send
TEXT	Düz metin (opsiyonel payload)	Metin	Evet
IMAGE	Görsel dosya	Görsel	Evet
VIDEO	Video dosya	Video	Evet
AUDIO	Ses dosya	Ses	Evet
FILE	Genel dosya eki	Dosya	Evet
MULTIPLE_CHOICE	Seçenekli soru (bot)	Çoktan seçmeli	Evet
MULTIPLE_CHOICE_REPLY	Seçime verilen yanıt	Çoktan seçmeli yanıt	Hayır
INTERACTIVE	Metin + aksiyon butonu	Etkileşimli	Evet
CAROUSEL	Kart listesi	Carousel	Evet
TEMPLATE	Şablon mesajı	Şablon	Hayır*

*Outbound şablon için Client API’de Push Mesaj kullanılır; type: TEMPLATE ile /message/send desteklenmez.

Render ipucu

1. isFromSupport ile balonu sağ/sol (veya gelen/giden) hizalayın.
2. type ile doğru bileşeni seçin.
3. data alanını o tipin şemasına göre okuyun; bilinmeyen tip için güvenli bir yedek gösterin.