API Referansı

Tüm API istekleri X-Api-Key başlığında gönderilen bir API anahtarıyla doğrulanır.

API anahtarınızı alma

1. Panelinizde Ayarlar → API Anahtarları'na gidin
2. API Anahtarı Oluştur'a tıklayın ve bir ad verin
3. Anahtarı hemen kopyalayın — yalnızca bir kez gösterilir
4. Güvenli bir şekilde saklayın (ortam değişkeni, gizli bilgi yöneticisi)

İstek yapma

Her istekte anahtarı ekleyin:

curl -H "X-Api-Key: tak_your_key_here" \
     https://api.enuchat.com/api/v1/tenant-api/widgets

Tüm yanıtlar JSON formatındadır. Başarılı yanıtlarda data alanı bulunur. Hatalarda code ve message içeren bir error alanı bulunur.

Güvenlik: API anahtarları veritabanımızda karmalanır (SHA-256). Ham anahtarı asla saklamayız. Anahtarınızı bir parola gibi değerlendirin — koda eklemeyin veya herkese açık paylaşmayın.

GET /widgets

Hesabınızdaki tüm bileşenleri listeler.

Yanıt

{'{'}
  "data": [
{'{'}
      "id": "019d19c6-7e0b-...",
      "name": "Main Website Chat",
      "isActive": true,
      "aiEnabled": true,
      "translationEnabled": true,
      "primaryColor": "#2563eb",
      "position": "bottom-right"
    }
  ]
}

GET /conversations

Konuşmaları en son mesaja göre sıralı listeler.

Sorgu Parametreleri

Örnek

curl -H "X-Api-Key: tak_..." \
     "https://api.enuchat.com/api/v1/tenant-api/conversations?status=open&limit=10"

Yanıt

{'{'}
  "data": [
{'{'}
      "id": "019d6724-000e-...",
      "widgetId": "019d19c6-7e0b-...",
      "visitorId": "v-abc123",
      "visitorName": "John",
      "visitorEmail": "john{'@'}example.com",
      "visitorLanguage": "en",
      "status": "open",
      "assignedTo": null,
      "lastMessageAt": "2026-04-11T14:30:00+00:00",
      "startedAt": "2026-04-11T14:25:00+00:00"
    }
  ]
}

GET /conversations/{'{'}id}

Tüm mesajlarıyla birlikte bir konuşma getirir.

Sorgu Parametreleri

Yanıt

{'{'}
  "data": {'{'}
    "id": "019d6724-000e-...",
    "visitorLanguage": "en",
    "status": "open",
    "messages": [
{'{'}
        "id": "019d6724-1234-...",
        "role": "visitor",
        "content": "Hello, how much does it cost?",
        "contentLanguage": "en",
        "translatedContent": "Cześć, ile to kosztuje?",
        "translatedLanguage": "pl",
        "isAutoReply": false,
        "createdAt": "2026-04-11T14:25:30+00:00"
      },
{'{'}
        "id": "019d6724-5678-...",
        "role": "ai",
        "content": "Our plans start at €19/month...",
        "isAutoReply": true,
        "createdAt": "2026-04-11T14:25:32+00:00"
      }
    ]
  }
}

POST /conversations/{'{'}id}/messages

Bir konuşmaya mesaj gönderir. Mesaj sohbet bileşeni üzerinden ziyaretçiye gerçek zamanlı iletilir.

İstek Gövdesi

{'{'}
  "content": "Thanks for reaching out! We'll process your request.",
  "role": "system"
}

Yanıt (201 Created)

{'{'}
  "data": {'{'}
    "id": "019d6725-abcd-...",
    "role": "system",
    "content": "Thanks for reaching out!",
    "createdAt": "2026-04-11T14:35:00+00:00"
  }
}

PATCH /conversations/{'{'}id}

Bir konuşmanın durumunu veya atamasını günceller.

İstek Gövdesi

{'{'}
  "status": "closed"
}

GET /billing/balance

Mevcut planınızı ve kredi bakiyenizi getirir.

Yanıt

{'{'}
  "data": {'{'}
    "plan": "pro",
    "creditBalance": 4500000,
    "totalCreditsAdded": 10000000
  }
}

CRM Entegrasyonu

Yeni konuşmaları sorgulayın ve ziyaretçi verilerini (ad, e-posta, dil) CRM'inize senkronize edin. Harici referans olarak konuşma kimliğini kullanın.

Otomatik Takipler

Bir konuşma kapatıldıktan sonra API üzerinden takip mesajı gönderin: "Sohbet ettiğiniz için teşekkürler! Yardımcı olabileceğimiz başka bir konu var mı?"

Webhook Alternatifi

Giden webhook'lar kullanılabilir olana kadar, yeni mesajları veya durum değişikliklerini algılamak için konuşmalar endpoint'ini düzenli aralıklarla sorgulayın.

Toplu İşlemler

7 günden eski tüm konuşmaları kapatın, harici mantığa göre konuşmaları operatörlere atayın veya analiz için konuşma geçmişini dışa aktarın.