Sohbetler

​

Endpoint özeti

​

Nesne modeli

​

Listeleme ve filtreler

curl -G "https://app.flextell.ai/api/v1/conversations" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  --data-urlencode "channel_type=whatsapp" \
  --data-urlencode "archived=false" \
  --data-urlencode "scope=assigned" \
  --data-urlencode "per_page=20"

const params = new URLSearchParams({
  channel_type: "whatsapp",
  archived: "false",
  scope: "assigned",
  per_page: "20",
});

const res = await fetch(`https://app.flextell.ai/api/v1/conversations?${params}`, {
  headers: {
    Authorization: "Bearer <access_token>",
    "X-Tenant": "<tenant_id>",
  },
});
const { data, meta } = await res.json();

​

Sohbet oluşturma

• customer_id: var olan bir hasta.
• lead_id: var olan bir lead.
• channel_id ve address: kanal ve adres. Kişi henüz yoksa oluşturulur.

• Kanal seçimi. customer_id veya lead_id ile channel_id vermezseniz sunucu kanalı sırayla bulur: hastanın son gelen mesajının kanalı, hastanın varsayılan kanalı, kliniğin varsayılan bildirim kanalı, hastaya ulaşılabilen ilk etkin ve bağlı kanal. WhatsApp gibi telefon kanallarında telefon numarası yeterlidir. Telegram, Instagram ve web sitesinde kişinin bir kimliği ya da o kanalda bir sohbeti olmalıdır.
• Tekrar çağrı. Aynı kanal ve normalize edilmiş adres için tekrar çağrı aynı sohbeti ve aynı kişiyi döndürür. Silinmiş sohbet geçmişiyle geri gelir.
• Lead oluşturma. contact_type=lead ile yeni bir adres, etkin pipeline’ın ilk aşamasında yeni bir lead olur. Etkin pipeline yoksa hiçbir şey oluşmaz ve 422 LEAD_NO_ACTIVE_PIPELINE döner. contact_type vermezseniz yeni kişi lead’siz bir hasta olur; API hiçbir zaman örtük lead oluşturmaz.
• Kısıt. Çözülen adres başka bir hastanın sohbetine aitse (silinmiş olsa bile) 409 CONVERSATION_ADDRESS_TAKEN döner.

curl -X POST "https://app.flextell.ai/api/v1/conversations" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{
    "channel_id": 123,
    "address": "+90 5xx xxx xx xx",
    "contact_type": "lead",
    "first_name": "Ayşe",
    "last_name": "Yılmaz"
  }'

const res = await fetch("https://app.flextell.ai/api/v1/conversations", {
  method: "POST",
  headers: {
    Authorization: "Bearer <access_token>",
    "X-Tenant": "<tenant_id>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    channel_id: 123,
    address: "+90 5xx xxx xx xx",
    contact_type: "lead",
    first_name: "Ayşe",
    last_name: "Yılmaz",
  }),
});
const { data: conversation } = await res.json();

​

Okundu ve okunmamış

• Bu üç çağrı da müşteriye “görüldü” bilgisi (mavi tik) göndermez.
• Giden mesajlar hiçbir zaman personel işlemiyle okundu olmaz.
• Okundu yapılan her sohbet için bir ConversationRead olayı yayınlanır. Olaylar için Kanallar ve olaylar sayfasına bakın.
• /open, silinmiş (imha edilmiş) hastanın sohbetinde de çalışır.

​

Arşiv, etiket ve dışa aktarma

​

Arşiv

• Arşiv durumu klinik genelindedir; kimin arşivlediği archived_by_user_name alanında görünür.
• Hasta yeniden yazarsa sohbet kendiliğinden arşivden çıkar. Kliniğin gönderdiği mesajlar sohbeti arşivde bırakır.
• Zaten arşivdeki sohbeti arşivlemek 422 CONVERSATION_ALREADY_ARCHIVED, arşivde olmayanı çıkarmak 422 CONVERSATION_NOT_ARCHIVED döndürür.

​

Etiket

curl -X PUT "https://app.flextell.ai/api/v1/conversations/123/tags" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{"tags": [4, 9]}'

​

Dışa aktarma

curl -X POST "https://app.flextell.ai/api/v1/conversations/123/export" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-Tenant: <tenant_id>" \
  -H "Content-Type: application/json" \
  -d '{"format": "csv", "export_all": false, "message_count": 500}' \
  -o sohbet-123.csv

​

Silme

​

Görünürlük

​

Başkasına atanmış lead’ler

• customer.is_masked değeri true olur. Ad ilk iki harfe (Jo••), telefon ve adres son iki hane dışında maskelenir. avatar_url boş gelir.
• record_state değeri {is_read_only: true, reason_code: "LEAD_NOT_ASSIGNED"} olur.
• Her yazma işlemi 403 LEAD_NOT_ASSIGNED döndürür. /messages, /open, /read, /export gibi okuma uçları bu kilide takılmaz.

​

Hata kodları