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

# Örnek istekler

> MCP araçlarını HTTP üzerinden çağırın; sohbetleri okuyun, rapor alın ve yazma araçlarını kullanın.

Örneklerde `ILETISIM_API_KEY` ortam değişkeni kullanılır. Kendi anahtarınızı çalıştırdığınız ortamın gizli değişken alanında tanımlayın. Aşağıdaki komutların içinde gerçek anahtar bulunmaz.

## Bağlantıyı ve araç listesini kontrol edin

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```

Yanıttaki `result.tools` listesinde okuma anahtarı için dört, yazma anahtarı için altı araç bulunur. Her aracın `inputSchema` alanı kabul ettiği parametreleri gösterir.

## Açık sohbetleri listeleyin

Örneğin, bir servis işletmesinin asistanı cevaplanacak sohbetlerin son mesajlarını listeleyebilir:

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "sohbetleri_listele",
      "arguments": { "durum": "open", "limit": 10 }
    }
  }'
```

`result.structuredContent.sohbetler` içinden sohbetin `id` değerini alın. Sonraki örneklerdeki kurgusal `11111111-1111-4111-8111-111111111111` kimliğinin yerine bu değeri kullanın.

## Bir sohbetin mesajlarını okuyun

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "sohbet_mesajlari",
      "arguments": {
        "sohbet_id": "11111111-1111-4111-8111-111111111111",
        "limit": 20
      }
    }
  }'
```

Son mesajlar eskiden yeniye gelir. `yon: "not"` olan kayıtlar iç nottur.

## Müşteri arayın

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 4,
    "method": "tools/call",
    "params": {
      "name": "musteri_ara",
      "arguments": { "arama": "Demo", "limit": 5 }
    }
  }'
```

Arama sonucundaki `id` bir kişi kimliğidir. Mesaj araçları için `sohbetleri_listele` sonucundaki sohbet kimliğini kullanın.

## Haftalık iletişim raporu alın

Bir ajansın haftalık müşteri iletişimini değerlendirmek için:

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 5,
    "method": "tools/call",
    "params": {
      "name": "iletisim_raporu",
      "arguments": { "gun": 7 }
    }
  }'
```

`totals` ve `previous` alanları aynı uzunluktaki iki dönemi karşılaştırır. İlk cevap süreleri dakika cinsindedir; ölçüm yoksa `null` döner.

## Sohbete iç not ekleyin

Bu örnek **yazma yetkisi** gerektirir ve sohbete yeni iç not ekler:

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 6,
    "method": "tools/call",
    "params": {
      "name": "not_ekle",
      "arguments": {
        "sohbet_id": "11111111-1111-4111-8111-111111111111",
        "metin": "Tamirhane ekibi parça durumunu kontrol edecek."
      }
    }
  }'
```

Not müşteriye gitmez. Başarılı sonuç `eklendi: true` ve `not_id` içerir.

## Müşteriye mesaj gönderin

Bu örnek **yazma yetkisi** gerektirir ve müşteriye mesaj gönderir. Gerçek bir sohbette çalıştırmadan önce metni ve alıcıyı kontrol edin. WhatsApp'ta 24 saatlik mesajlaşma penceresi açık olmalıdır.

```bash theme={"system"}
curl --request POST 'https://api.iletisim.app/api/mcp' \
  --header "Authorization: Bearer ${ILETISIM_API_KEY}" \
  --header 'Content-Type: application/json' \
  --data '{
    "jsonrpc": "2.0",
    "id": 7,
    "method": "tools/call",
    "params": {
      "name": "mesaj_gonder",
      "arguments": {
        "sohbet_id": "11111111-1111-4111-8111-111111111111",
        "metin": "Merhaba, servis kaydınızla ilgili bilgiyi hazırlıyoruz."
      }
    }
  }'
```

Başarılı yanıtın biçimi şöyledir; `mesaj_id` örnektir:

```json theme={"system"}
{
  "jsonrpc": "2.0",
  "id": 7,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"gonderildi\":true,\"mesaj_id\":\"22222222-2222-4222-8222-222222222222\"}"
      }
    ],
    "structuredContent": {
      "gonderildi": true,
      "mesaj_id": "22222222-2222-4222-8222-222222222222"
    }
  }
}
```

`gonderildi: true`, gönderimin kabul edildiğini gösterir. Teslim durumunu paneldeki sohbetten kontrol edin. `result.isError` varsa açıklamayı okuyun; yazma isteğini tekrar göndermek yeni bir mesaj veya not oluşturabilir.

Son güncelleme: 23 Ekim 2026


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