Örnek istekler - İletişim

Ö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

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:

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

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

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:

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:

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.

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:

{
  "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

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

​Açık sohbetleri listeleyin

​Bir sohbetin mesajlarını okuyun

​Müşteri arayın

​Haftalık iletişim raporu alın

​Sohbete iç not ekleyin

​Müşteriye mesaj gönderin