Mesaj Gönderme

POST /message/send

Var olan bir sohbete mesaj ekler. Chat, access token’daki şirkete ait olmalıdır.

24 saat kuralı

Bu endpoint yalnızca konuşma süreci devam eden, son 24 saat içindeki kullanıcılara / sohbetlere mesaj göndermek içindir.

Durum	Sonuç
Sohbet son 24 saat içinde	Mesaj gönderilebilir
24 saat dolmuş	Bu endpoint ile mesaj gönderilemez

24 saat dolduktan sonra kullanıcıya ulaşmak istiyorsanız Push Mesaj (POST /push-message) özelliğini kullanın.

Header: x-access-token zorunludur. Ayrıntılar: Kimlik doğrulama.

İstek

POST /message/send HTTP/1.1
Host: client-api.chatbot.aithinks.net
Content-Type: application/json
x-access-token: <sirket-access-token>

Body alanları

Alan	Tip	Zorunlu	Açıklama
type	string	Evet	Mesaj tipi — Mesaj Tipleri
data	object	Evet	Mesaj içeriği — tipe göre şema
chatId	uuid	Evet	Hedef chat kimliği

Mesaj tipleri

type ve data yapıları ortak Mesaj Tipleri şemalarını kullanır. Bu endpoint’te MULTIPLE_CHOICE_REPLY ve TEMPLATE desteklenmez.

Tip	Doküman
TEXT	Metin
IMAGE	Görsel
VIDEO	Video
AUDIO	Ses
FILE	Dosya
MULTIPLE_CHOICE	Çoktan seçmeli
INTERACTIVE	Etkileşimli
CAROUSEL	Carousel

Örnek

await fetch(`${BASE_URL}/message/send`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-access-token': ACCESS_TOKEN,
  },
  body: JSON.stringify({
    type: 'TEXT',
    data: { text: 'Merhaba' },
    chatId: '11111111-1111-1111-1111-111111111111',
  }),
});

curl -X POST https://client-api.chatbot.aithinks.net/message/send \
  -H "Content-Type: application/json" \
  -H "x-access-token: YOUR_TOKEN" \
  -d '{
    "type": "TEXT",
    "data": { "text": "Merhaba" },
    "chatId": "11111111-1111-1111-1111-111111111111"
  }'

Başarılı yanıt

{
  "message": "Message sent successfully"
}

Hatalar

Kod	Durum
400	Validasyon hatası veya sohbet 24 saatten eski (Chat is too old. Please start a new chat.) — bu durumda Push Mesaj kullanın
401	Token eksik / geçersiz
404	Chat bulunamadı veya şirkete ait değil

Ortak hata gövdesi: Hata formatı.