> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iletisim.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Araçlar

> İletişim MCP araçlarının yetkileri, parametreleri, varsayılanları ve yanıt alanları.

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. |

```json theme={"system"}
{
  "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 `null`dı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. |

```json theme={"system"}
{
  "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. |

```json theme={"system"}
{
  "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 `null`dı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. |

```json theme={"system"}
{
  "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. |

```json theme={"system"}
{
  "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. |

```json theme={"system"}
{
  "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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.