Konuşma meta verileri

Konuşma meta verileri, konuşmalara özel anahtar-değer verileri ekleyerek sistemlerinizle AI Temsilciniz arasında güçlü bir bağlantı kurmanızı sağlar. Meta veriler Quickchat iş akışınızın tamamında kullanılır:

• API üzerinden aktarım: Herhangi bir konuşmaya programatik olarak meta veri eklemek için bu uç noktaları kullanın (örneğin CRM, yardım masası veya arka uç sisteminizden)
• Widget/yerleştirme üzerinden aktarım: Widget yüklenirken meta verileri başlatma parametreleri olarak gönderin veya JavaScript SDK ile etkin konuşma sırasında dinamik olarak ekleyin
• Kontrol panelinde görünürlük: Özel meta veriler Gelen Kutusunun konuşma ayrıntılarında görünür. Dahili anahtarlar filtrelenir; yakalanan iletişim bilgileri ve Eylem belleği ayrı biçimde gösterilir
• Dışa aktarımlara dahil edilme: Kontrol panelinden konuşmaları dışa aktardığınızda meta veriler de eklenir ve çevrimdışı analizde kullanılabilir
• AI Eylemlerinde kullanım: Meta veri değerleri doğrudan {{metadata_<key>}} yer tutucuları olarak AI Eylemlerine eklenebilir. Kullanılabilir yer tutucuların tümü için AI Eylemi Değişkenleri sayfasına bakın
• İzin verildiğinde AI Temsilcisine sunulma: Model bağlamı, meta verilerin filtrelenmiş bir alt kümesini kullanır. Bir anahtarın saklanması, modelin onu alacağını veya ondan söz edeceğini garanti etmez

Meta verileri müşteri referansları, hesap bağlamı, analizler ve Eylem girdileri için kullanın. Saklama, Gelen Kutusunda gösterme, Eylem değişkenlerine yerleştirme ve model bağlamı aynı verinin ayrı kullanım alanlarıdır.

Kontrol panelinde yapılandırılmışsa meta veriler bir JSON şemasına göre doğrulanır.

İsteğe bağlı örnek kontrolleri

• Meta veri anahtarlarını önizleyin. Yinelenen adlar ve ayrılmış anahtar hataları dahil verilen alan adlarının değişken anahtarlarına nasıl dönüştüğünü kontrol edin. Bu araç değerleri veya hesaba özel izinleri incelemez.

• Eylem çalıştırma koşullarını kontrol edin. Bir Eylemi çalıştırmadan koşulları sağlanan örnek meta verilere göre değerlendirin.

Uyumlu bir tarayıcıda bu kontroller site araçları olarak da kullanılabilir. Bağlantılar standart formları açar.

Model bağlamı ve yetkilendirme

Web sitesi Widget’ı ve Yerleştirme gibi ziyaretçinin kontrolündeki kanallarda model bağlamı, ziyaretçi iletişim anahtarlarını (visitor_name, visitor_email, visitor_phone_number) ve etkin Eylemlerin başvurduğu veya yakaladığı uygun anahtarları kabul eder. Dahili ve ayrılmış değerler filtrelenir; yapılandırma ve boyut sınırları da uygulanır. Diğer entegrasyonların kanala özel bağlam kuralları vardır. Özel bir customer_tier veya customer_id anahtarı, yalnızca gönderdiniz diye model tarafından otomatik görülemez.

Bir Eylem, modelden bu değeri üretmesini istemeden, isteğini oluştururken {{metadata_<key>}} değerini yerleştirebilir. Bu, sıradan meta verileri gizli yapmaz: uygun bir değer ayrı olarak model bağlamına girebilir veya bir Eylem yanıtında görünebilir. API anahtarlarını veya şifreleri özel meta verilerde saklamayın.

Tarayıcıdan sağlanan meta veriler kimlik veya izin kanıtı değildir. Alıcı hizmetiniz özel kayıtlara erişim için kimlik doğrulaması ve yetkilendirme yapmalıdır; tarayıcıdan gönderilen müşteri kimliği veya plan düzeyi yeterli değildir. Yapılandırmanızda hem oluşan Eylem isteğini hem de temsilcinin yanıtını test edin.

Meta verileri alma

Kapsam: read_all

GET https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

Shell

curl https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Yanıt 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

Meta verileri ayarlama

Bir konuşmanın meta verilerini oluşturun veya güncelleyin.

Kapsam: write_all

POST https://app.quickchat.ai/v1/api_core/conversations/{conv_id}/metadata

İstek gövdesi

Parametre	Açıklama
metadata nesne, zorunlu	Saklanacak anahtar-değer meta verileri

Shell

curl -X POST https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api_core/conversations/conv-uuid-1234/metadata",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "metadata": {"ticket_id": "T-1234", "priority": "high"}
    },
)
data = response.json()

Yanıt 200 OK

{
  "metadata": {
    "ticket_id": "T-1234",
    "priority": "high"
  }
}

---