Session Link

Geliştirici API'si

Bir müşterinin konuşmasına kendi sistemlerinizden doğrudan bağlantı alın; müşteri ve konuşma henüz yoksa oluşturulur.

• WhatsApp
• Instagram
• REST API

MonoStore'dan kurunmonochat.ai'de inceleyin

Genel bakış

Bir kanal ile müşterinin telefon numarası veya e-postasını içeren tek bir API çağrısı, o müşterinin konuşmasını MonoChat'te açan bir bağlantı döndürür. Müşteri veya konuşma henüz yoksa oluşturulur.

Bağlantıyı CRM'inize, yardım masanıza veya sipariş ekranınıza koyun; ekibiniz oradan doğrudan sohbete geçsin.

Öne çıkanlar

• Aç veya oluştur. Belirli bir WhatsApp, Instagram veya başka bir kanaldaki müşteri için, telefon numarası veya e-posta ile çalışır.
• Yolda yönlendirin. Konuşmayı aynı çağrıda kimliği veya e-postasıyla bir temsilciye ya da bir çalışma grubuna atayın.
• Aynı müşteri, aynı konuşma. Aynı müşteri ve kanal için tekrar çağırmak mevcut konuşmayı döndürür.

Kurulum

1. Session Link uygulamasını Ayarlar › MonoStore › Uygulamalar bölümünden yükleyin ya da kurulum bağlantısını açın: app.monochat.ai/apps/vvKJe8Nbp4EQNy2KA. MonoChat hesabınız yoksa bağlantı önce kaydolmanızı sağlar ve uygulamayı sizin için yükler.
2. Profil › API Tokenları altında bir API token'ı oluşturun. Token yalnızca bir kez gösterilir; hemen kopyalayın. Bkz. API Tokenları.
3. Ayarlar › Session Link API ekranını açın. Buradaki dokümantasyon, çalışma alanınıza ait tam uç nokta adresini ve kopyalanmaya hazır örnek istekleri gösterir. Örneği kanallarınızdan biriyle deneyin.
4. CRM'inize, yardım masanıza ya da sipariş ekranınıza API'yi çağıran ve dönen url adresini açan bir "WhatsApp'ta sohbet et" düğmesi ekleyin.

not

• Bağlantı, MonoChat'i oturum açmış ve o konuşmayı görmeye yetkili kişiler için açar.
• Çağrı yalnızca konuşmayı açar; müşteriye mesaj göndermez. İlk yazan siz olmak için WhatsApp Template API'yi kullanın.

Özellikler

Konuşma bağlantısı

Yanıt, konuşmayı MonoChat'te açan bağlantıyı ve konuşmanın kimliğini verir.

Gerekirse müşteri oluşturulur

Gönderdiğiniz ad ve soyadla yeni bir müşteri oluşturulur; yanıt, müşterinin daha önce tanınıp tanınmadığını bildirir.

Atama

Kimliği veya e-postasıyla bir temsilciye ya da bir çalışma grubuna atayın.

Dokümantasyon ekranı

Çalışma alanınızın tam uç nokta adresini ve kopyalamaya hazır örnek istekleri içeren API referansı.

API başvurusu

Çağrı, JSON gövdeli bir POST isteğidir ve bir API token'ı ile doğrulanır.

POST https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js
Authorization: Bearer <API_TOKEN>
Content-Type: application/json

• <slug>, çalışma alanınızın tenant slug'ıdır; MonoChat adresinizde /tenants/ sonrasındaki kısımdır.
• <app-folder>, uygulamanın yüklendiği klasördür. Ayarlar › Session Link API ekranı, ikisi de doldurulmuş tam adresi gösterir.
• Token'ı Profil › API Tokenları altında oluşturun. Bkz. API Tokenları.

İstek alanları

Alan	Zorunlu	Açıklama
connectorBrand	evet	Kanal türü, örneğin whatsapp ya da instagram.
channelUsername	evet	Kanalınızın MonoChat'teki kullanıcı adı, örneğin + olmadan WhatsApp numaranız.
customer.identityType	evet	phoneNumber ya da email.
customer.identity	evet	Müşterinin telefon numarası (ülke koduyla, + olmadan) ya da e-posta adresi.
customer.firstname, customer.lastname	hayır	Müşteri MonoChat'te yeniyse kullanılır. Varsayılan -.
assignment.type	hayır	agent (temsilci kullanıcı kimliği), agentIdentity (temsilci e-postası) ya da workgroup (çalışma grubu kimliği).
assignment.value	assignment.type ile	Konuşmanın atanacağı kimlik ya da e-posta.

Örnek istek

curl --location 'https://app.monochat.ai/api/<slug>/custom-functions/<app-folder>/methods/session-link.js' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <API_TOKEN>' \
--data '{
  "connectorBrand": "whatsapp",
  "channelUsername": "905334445566",
  "customer": {
    "identityType": "phoneNumber",
    "identity": "905306667788",
    "firstname": "Ayşe",
    "lastname": "Yılmaz"
  },
  "assignment": { "type": "agentIdentity", "value": "sarah@sirketiniz.com" }
}'

Yanıt

{
  "result": {
    "url": "https://app.monochat.ai/tenants/<slug>?tab=messages&sessionTab=all&filter=…&_id=<sessionId>",
    "sessionId": "Zeii7vpeeFFnsJepZ",
    "isOldUser": true
  }
}

Alan	Açıklama
url	Konuşmayı MonoChat'te açar.
sessionId	Konuşmanın kimliği. Aynı kanaldaki aynı müşteri her zaman aynı konuşmayı alır.
isOldUser	Müşteri bu çağrıyla oluşturulduysa false olur.

Hatalar

Başarısız bir çağrı, hata durum kodu ve bir mesajla yanıt verir:

Mesaj	Nedeni
connectorBrand, channelUsername and customer fields are required	Zorunlu üst düzey alanlardan biri eksik.
customer.identityType must be one of: phoneNumber, email	identityType eksik ya da başka bir değer içeriyor.
customer.identity field is required	Müşterinin telefon numarası ya da e-postası eksik.
Channel not found	Çalışma alanınızda bu türde ve bu kullanıcı adında bir kanal yok.
Customer Channel not found	Müşteri bir kanal kimliğiyle eşleştirilemedi.
Agent user not found	assignment.value içindeki e-postaya sahip bir temsilci yok.
401	Authorization başlığı eksik ya da token geçersiz.

Ekran görüntüleri

Bir CRM, yardım masası ve sipariş yönetimi ekranı; her biri MonoChat'te doğru konuşmayı açıyorKonuşmayı aynı API çağrısında bir temsilciye veya çalışma grubuna atamaAPI isteğinden otomatik olarak oluşturulan yeni bir müşteri ve konuşmaTek bir API çağrısı konuşma bağlantısını döndürürBir CRM'deki “WhatsApp'ta sohbet et” düğmesi müşterinin konuşmasını tek tıkla açarAynı müşteri için API'yi tekrar çağırmak mevcut konuşmayı açar

Sık sorulan sorular

Session Link müşteriye mesaj gönderir mi?

Hayır. Yalnızca konuşmayı açar veya oluşturur ve ona bir bağlantı döndürür. Müşteriye ilk siz yazmak için WhatsApp Template API uygulamasını kullanın.

Hangi kanallarla çalışır?

WhatsApp, Instagram ve MonoChat çalışma alanınıza bağlı diğer kanallar. İstekte kanal türünü ve kanalınızın kullanıcı adını belirtirsiniz.

Yinelenen konuşmalar oluşturur mu?

Hayır. Aynı kanaldaki aynı müşteri her zaman aynı konuşmayı alır.

Bağlantıyı kimler açabilir?

MonoChat'te oturum açmış ve o konuşmayı görmeye yetkili kişiler.

İlgili sayfalar

• WhatsApp Template API
• MonoStore uygulamaları
• Profil Ayarları
• Çalışma Grupları