Araçlar

MCP sunucusunda altı araç bulunur. read anahtarı dört okuma aracını, write anahtarı altı aracın tamamını kullanır. Araçları tools/call yöntemiyle çağırın; güncel JSON şemalarını tools/list ile alabilirsiniz. Tüm örneklerdeki UUID değerleri kurgusaldır. Çağrınızda kendi İşletmenizin araç yanıtlarından aldığınız kimlikleri kullanın.

sohbetleri_listele

Yetki: read veya write. WhatsApp, Instagram ve Messenger sohbetlerini son mesajı en yeni olan başta olacak şekilde listeler. Ad veya telefonla arama yapabilirsiniz.

Parametre	Tür	Zorunlu	Kural / varsayılan
`durum`	Metin	Hayır	`open`, `pending`, `closed`; varsayılan `open`.
`arama`	Metin	Hayır	Müşteri adı veya telefon; en fazla 100 karakter.
`limit`	Tam sayı	Hayır	1–50; varsayılan 20.

{
  "name": "sohbetleri_listele",
  "arguments": { "durum": "pending", "limit": 10 }
}

Sonuç: sohbetler dizisi. Her öğe id, kanal, musteri, telefon, durum, son_mesaj, son_mesaj_yonu, son_mesaj_zamani ve okunmamis alanlarını içerir. son_mesaj_zamani ISO tarih veya nulldır. id, mesaj okuma ve yazma araçlarında sohbet_id olarak kullanılır.

sohbet_mesajlari

Yetki: read veya write. Bir sohbetin son mesajlarını, seçilen son mesaj kümesi içinde eskiden yeniye sıralı olarak getirir. Ekibin iç notları da sonuçta yer alır.

Parametre	Tür	Zorunlu	Kural / varsayılan
`sohbet_id`	UUID	Evet	Sohbetin kimliği.
`limit`	Tam sayı	Hayır	1–100; varsayılan 30.

{
  "name": "sohbet_mesajlari",
  "arguments": {
    "sohbet_id": "11111111-1111-4111-8111-111111111111",
    "limit": 30
  }
}

Sonuç: mesajlar dizisi. Her öğe zaman, yon, yazan, tur ve metin alanlarını içerir. yon; musteri, isletme veya not olur. yazan, yazarın adı, AI veya null olabilir.

musteri_ara

Yetki: read veya write. Kişileri ad veya telefonla arar; grup kartlarını sonuçlara katmaz. Son etkileşimi en yeni olan kayıt başta gelir.

Parametre	Tür	Zorunlu	Kural / varsayılan
`arama`	Metin	Evet	Baş ve son boşluklar çıkarıldıktan sonra 1–100 karakter.
`limit`	Tam sayı	Hayır	1–50; varsayılan 20.

{
  "name": "musteri_ara",
  "arguments": { "arama": "Demo", "limit": 5 }
}

Sonuç: musteriler dizisi. Her öğe id, ad, telefon, pazarlama_izni ve son_etkilesim alanlarını içerir. son_etkilesim ISO tarih veya nulldır. Buradaki id kişi kimliğidir; sohbet kimliği yerine kullanmayın.

iletisim_raporu

Yetki: read veya write. Son 7, 30 veya 90 günün gelen ve giden mesajlarını, kanal dağılımını, ilk cevap süresini, yeni müşteri ve sohbet sayılarını getirir. Dönemler İstanbul saatine göre hesaplanır.

Parametre	Tür	Zorunlu	Kural / varsayılan
`gun`	Tam sayı	Hayır	Yalnızca 7, 30 veya 90; varsayılan 30.

{
  "name": "iletisim_raporu",
  "arguments": { "gun": 7 }
}

Sonuç alanları:

Alan	İçerik
`range`	Seçilen dönem, önceki dönem ve zaman serisinin aralığı.
`messages`	Günlük `day`, `inbound` ve `outbound` değerleri.
`byChannel`	Kanal türü başına `channel`, `inbound`, `outbound`.
`firstResponseMinutes`	Dakika cinsinden `median`, `p90` ve ölçüm sayısı `samples`; ölçüm yoksa süreler `null`.
`newContacts`	Dönemde oluşan yeni kişi sayısı.
`conversations`	Dönemde müşterinin yazdığı sohbet sayısı.
`totals`	`inbound`, `outbound`, `conversations`, `newConversations`, `newContacts`, `firstResponseMedian`.
`previous`	Aynı uzunluktaki önceki dönemin, `totals` ile aynı alanları.
`series`	Zaman aralıklarına göre mesaj, sohbet, yeni kişi ve ilk cevap süresi değerleri.
`byAccount`	Her kanal hesabının kimliği, kanal türü, adı, proje kimliği ve gelen/giden mesaj sayıları.
`heatmap`	`heatmap[gün][saat]` biçiminde gelen mesaj sayıları; gün 0 Pazartesi, gün 6 Pazar; saat 0–23.

Bu araçta proje, kanal veya temsilci süzgeci bulunmaz; rapor İşletmenin verisini kapsar.

mesaj_gonder

Yetki: write. Mevcut sohbetten müşteriye metin mesajı gönderir. WhatsApp’ta müşterinin son mesajından sonraki 24 saat içinde serbest metin gönderilebilir. Bu araç şablon mesaj göndermez.

Parametre	Tür	Zorunlu	Kural
`sohbet_id`	UUID	Evet	Sohbetin kimliği.
`metin`	Metin	Evet	Baş ve son boşluklar çıkarıldıktan sonra 1–4.000 karakter.

{
  "name": "mesaj_gonder",
  "arguments": {
    "sohbet_id": "11111111-1111-4111-8111-111111111111",
    "metin": "Servis kaydınızla ilgili güncel bilgiyi hazırlıyoruz."
  }
}

Sonuç: gonderildi: true ve mesaj_id. Bu sonuç mesajın gönderim için kabul edildiğini belirtir; müşteriye teslim teyidi değildir. Kanalın bağlantısı kesikse, mesajlaşma penceresi kapalıysa veya abonelik gönderime izin vermiyorsa işlem hata döner. Başarılı mesaj panelde API: anahtar adı etiketiyle görünür.

not_ekle

Yetki: write. Sohbete yalnızca ekibin göreceği bir iç not ekler. Bu işlem Notlar bölümünde bağımsız bir not oluşturmaz.

Parametre	Tür	Zorunlu	Kural
`sohbet_id`	UUID	Evet	Sohbetin kimliği.
`metin`	Metin	Evet	Baş ve son boşluklar çıkarıldıktan sonra 1–4.000 karakter.

{
  "name": "not_ekle",
  "arguments": {
    "sohbet_id": "11111111-1111-4111-8111-111111111111",
    "metin": "Mağaza ekibi stok bilgisini kontrol edecek."
  }
}

Sonuç: eklendi: true ve not_id. Metnin başına [API: anahtar adı] eklenir. Not müşteriye gitmez.

Tekrar deneme

Okuma araçları kayıtları değiştirmez. mesaj_gonder ve not_ekle her çağrıda yeni bir kayıt oluşturur; yanıt kesilirse isteği tekrarlamadan önce sohbeti kontrol edin. Son güncelleme: 23 Ekim 2026

Bağlantı

Başvuru

sohbetleri_listele

sohbet_mesajlari

musteri_ara

iletisim_raporu

mesaj_gonder

not_ekle

Tekrar deneme

​sohbetleri_listele

​sohbet_mesajlari

​musteri_ara

​iletisim_raporu

​mesaj_gonder

​not_ekle

​Tekrar deneme

sohbetleri_listele

sohbet_mesajlari

musteri_ara

iletisim_raporu

mesaj_gonder

not_ekle

Tekrar deneme