Ayarlar, Kanallar: her bağlantı ve çalıştığı mod.
Henüz hiçbir kanalın bağlı olmadığı bir çalışma alanı.
Intercom bağlayın
Kai, ekibinizin zaten kullandığı gelen kutusunun içinde çalışır. Kai taslakları dahili not olarak yazar ve bir görüşmeyi atama yaparak devreder.1
Bir erişim jetonu alın
Intercom’da Developer Hub → uygulamanız → Configure → Authentication
bölümünü açın. Erişim jetonunu kopyalayın. Jeton tek bir çalışma alanı için
geçerlidir, bu yüzden Kai çalışma alanını jetondan öğrenir.
2
Client secret değerini alın (önerilir)
Aynı uygulamada Basic Info bölümünü açın ve client secret değerini
kopyalayın. Intercom’un kendi jeton akışında bu değer isteğe bağlıdır, bu
yüzden Kai de onu isteğe bağlı sayar. Atlamadan önce
Hangi gizli değeri kullanmalı bölümünü
okuyun.
3
İkisini de Kai'ye yapıştırın
Ayarlar (Settings) → Kanallar (Channels) bölümünde Kanal ekle (Add
channel), sonra Intercom seçeneğini seçin. Erişim jetonunu ve varsa
client secret değerini yapıştırın. Bağlan (Connect) seçeneğini seçin.
Kai hiçbir şey kaydetmeden önce jetonu Intercom ile doğrular.
4
Webhook adresini Intercom'a ekleyin
Kai bağlantıdan sonra bir URL gösterir. Intercom’da Developer Hub →
uygulamanız → Webhooks bölümünü açın ve bu URL’yi ekleyin.
5
Dört konuya abone olun
conversation.user.created, conversation.user.replied,
conversation.admin.replied ve conversation.admin.closed konularına abone
olun. Bir insanın devraldığını anlamak için Kai’nin yönetici yanıtlarına
ihtiyacı vardır.Kai jetonu kendi sunucunuzda şifreli olarak saklar. Bir jetonu yenilemek veya
sonradan client secret eklemek için bağlantı akışını yeni değerlerle bir daha
çalıştırın.
Hangi gizli değeri kullanmalı
Kai bir bildirimin gerçek olduğunu iki yolla doğrular.
İmza ikisinin güçlü olanıdır, çünkü yalnızca çağrıyı yapanı değil mesajın
kendisini de doğrular. Bir URL bir günlük dosyasına başlıktan daha kolay
düşer.
WhatsApp Cloud bağlayın
Bir WhatsApp Business numarası doğrudan Kai ile konuşur. Sağlayıcı tarafında bir gelen kutusu yoktur, bu yüzden ekibiniz Kai’nin gelen kutusundan yanıt verir.1
Meta'dan üç değer toplayın
Meta App Dashboard → WhatsApp → API Setup bölümünü açın. Access
token, Phone number ID ve WhatsApp Business Account ID
değerlerini kopyalayın. 24 saatlik test jetonunu değil, kalıcı bir sistem
kullanıcısı jetonunu kullanın.
2
App secret değerini kopyalayın (önerilir)
Uygulamanın Basic Settings bölümünü açın ve app secret değerini
kopyalayın. Bu değerle Kai her bildirimin imzasını doğrular. Bu değer
olmadan çağrıyı yapanı gizli webhook adresi doğrular.
3
Değerleri Kai'ye yapıştırın
Ayarlar (Settings) → Kanallar (Channels) bölümünde Kanal ekle (Add
channel), sonra WhatsApp Cloud seçeneğini seçin. Değerleri yapıştırın
ve Bağlan (Connect) seçeneğini seçin. Kai hiçbir şey kaydetmeden önce
bunları Meta ile doğrular.
4
Kai'nin sizin için ne yaptığını okuyun
Kai numarayı Cloud API için kaydeder ve webhook alanlarını kendi geri
çağırma adresine abone eder. Sonuç sayfası her adımı listeler ve
hangilerinin tamamlandığını belirtir.
5
Kai'nin yapamadıklarını tamamlayın
Kai webhook aboneliğini yapamadıysa Callback URL ve Verify token
değerlerini gösterir. Meta’da App Dashboard → WhatsApp → Configuration →
Webhook bölümünü açın, ikisini de yapıştırın, sonra
messages alanına
abone olun.messages aboneliği, geri çağırma adresi ve
uygulama aboneliği. Kimlik bilgileri hâlâ geçerliyken mesajlar gelmemeye
başlarsa önce bu paneli okuyun.
Bir kanalın içindeki kaynaklar
Tek bir Intercom çalışma alanı, tek bir kimlik bilgisi ve tek bir webhook üzerinde birkaç yüzey taşır. Intercom bunların her birine source der. Kai; Messenger, WhatsApp, e-posta, SMS, Instagram, Facebook ve telefon kaynaklarını tanır. Bu yüzeyler tek bir kitle değildir. Messenger ziyaretçisi çoğu zaman anonimdir. WhatsApp görüşmesi ise size yazmayı seçmiş bir telefon numarasıdır. Çoğu ekip bu ikisine farklı güvenir. Bu yüzden her kaynak kendi modunu taşıyabilir. Kanal kartını açın ve Kaynak bazlı modlar (Per-source modes) bölümünü bulun. Her kaynak Devral (Inherit), Copilot, Autopilot ve Kapalı (Off) seçeneklerini sunar. Devral (Inherit) varsayılan durumdur ve üstteki kanala verilen modu izler.
Açık bir kanal kartı: mod, autopilot kapsamı, bekleme, güven ve kaynak bazlı modlar.
Bağlantıyı test edin
Bir Intercom kartında Bağlantıyı test et (Test connection) düğmesi vardır. Düğme, kayıtlı kimlik bilgisinin hâlâ çalışıp çalışmadığını Intercom’a sorar ve çalışıyorsa çalışma alanının adını verir. Bir kanal sessizleştiğinde, herhangi bir politikayı değiştirmeden önce bunu kullanın. Bir WhatsApp kartında tek bir düğme yoktur, çünkü bir WhatsApp bağlantısı kendi başlarına bozulabilen dört adımdan oluşur. Teslimat kurulumu (Delivery setup) paneli her adımı denetler.Son etkinlikler
Her kanal kartı bir Son etkinlikler (Recent activity) listesi taşır. Liste, ne geldiğini ve Kai’nin neyi geri çevirdiğini kaydeder: bildirimler, reddedilen istekler, abonelikler, arşivlemeler ve Meta’nın bir WhatsApp Business Account için gönderdiği hesap uyarıları. Bir kanal bağlı görünüyor ama hiçbir şey olmuyorsa bu listeyi okuyun. Kalite düşüşü veya şablon kararı gibi bir hesap uyarısı, kimlik bilgileri tamamen geçerliyken bile teslimatı durdurur.Bir kanalı devre dışı bırakın
Kart altlığındaki Kanalı devre dışı bırak (Disable channel) seçeneğini seçin. Kai o bağlantı üzerinde işlem yapmayı bırakır. Intercom’da veya Meta’da hiçbir şey değişmez. Devre dışı bir kanalda iki işlem daha görünür:- Görüşmeleri arşivle (Archive conversations) kalan görüşmeleri geçmiş olarak saklar. Bunlar Kai içinde okunabilir ve aranabilir kalır, yeni yanıt kabul etmez. Sağlayıcıya hiçbir şey gönderilmez.
- Kanalı sil (Delete channel) bağlantıyı ve Kai’nin o bağlantıdan tuttuğu her görüşmeyi, mesajı ve şablonu kaldırır. Sağlayıcının kendisine dokunulmaz.
Mesaj şablonları
WhatsApp, müşterinin son mesajından 24 saat sonra görüşmeyi kapatır. Bundan sonra serbest biçimli mesaj başarısız olur. İlk yazan taraf olmak veya geç yazmak için Meta’nın onayladığı bir şablon göndermeniz gerekir. Şablon kütüphanesi Meta’ya aittir. Kai onun bir kopyasını tutar. Ayarlar (Settings) → Şablonlar (Templates) bölümünü açın.
Ayarlar, Şablonlar: kopyalanan kütüphane ve her değişkenin nasıl doldurulduğu.
1
Meta'dan eşitleyin
Meta’dan eşitle (Sync from Meta) seçeneğini seçin. Kai bu numaranın
onaylı ve onaysız bütün şablonlarını alır ve kaçını kaydettiğini, kaçını
kaldırdığını bildirir.
2
Her durumu okuyun
Bir şablon onaylı, beklemede, reddedilmiş, devre dışı veya duraklatılmış
olur. Yalnızca onaylı bir şablon gönderilebilir.
3
Her değişkeni bağlayın
Başlıktaki ve mesajdaki her
{{variable}} için değerin nereden geleceğini
seçin: temsilcinin yazdığı bir değer ya da kayıttan alınan bir isim. Kai
her seçimi tek tek kaydeder. Başlığı olan bir şablonda her değişkenin
yanında hangi bölüme ait olduğu yazar; çünkü WhatsApp’ta başlık ve mesaj
bir değişkene aynı adı verebilir.Kai, metin başlığının ve mesajın değişkenlerini doldurur. Kai’nin veremeyeceği
bir değer isteyen şablon temsilcilere sunulmaz ve satır bunu belirtir: görsel,
video veya belge başlığı bir dosya ister, değişken bağlantılı bir düğme de
metin değildir.
Direct Send
Bir WhatsApp kanal kartı Direct Send ayarını taşır. Bu ayarla temsilciler, 24 saatlik pencereden sonra şablon seçmek yerine serbest biçimli hizmet mesajları yazar. Meta bu izni hesap bazında verir. Bu ayarı yalnızca hesabınız ilgili beta programındaysa açın, çünkü diğer hesaplarda bu gönderimler şablona dönmez, başarısız olur.Sırada ne var
Copilot, autopilot ve kapalı
Her modun ne yaptığı ve bir yanıtı hâlâ neyin durdurduğu.
Ekip ve izinler
Bir kanalı kimin bağlayabileceği ve politikasını kimin değiştirebileceği.