Yardım Merkezi/Yapay zeka asistanı
AI ajanı nasıl tepki ekler ve müşteri tepkilerinden haberdar olur?
AI ajanının tepki eklemesi veya kaldırması için mesaj kimliği ve emoji ile /api/connect/react adresine istek gönderin. n8n senaryosunun müşteri tepkilerinden haberdar olması için AI ağ geçidi ayarlarında Müşteri tepkilerini yapay zekâya bildir seçeneğini etkinleştirin.
Tepki nasıl eklenir veya kaldırılır?
Authorization: Bearer <belirteç> başlığıyla POST /api/connect/react isteği gönderin. Belirteç, Kendi yapay zekânı bağla sayfasındaki Callback belirteci alanının değeridir. Müşteriye yanıt vermek için de aynı belirteç kullanılır.
İstek gövdesinde message_id ve emoji gönderin. Hem müşterinin mesajına hem de ajanın kendi gönderdiği mesaja tepki ekleyebilirsiniz.
Tepkiyi kaldırmak için boş dize gönderin: "emoji": "".
POST https://app.anylinga.com/api/connect/react
Authorization: Bearer <Callback belirteci>
Content-Type: application/json
{
"message_id": "6a1f3c2e-9b7d-4e5a-8c21-0d4b7e9f2a13",
"emoji": "👍"
}
message_id nereden alınır?
message_id, AnyLinga’daki mesaj kimliğidir. Müşterinin mesajına tepki eklemek için senaryonun aldığı gelen mesajdaki message_id alanını kullanın.
Ajanın metnine tepki eklemek için AnyLinga’nın callback veya /api/connect/send yanıtındaki message_id alanını kullanın. Metin olmadan yalnızca şablonlar gönderildiyse yanıtta message_id alanı bulunmaz.
Tepkiler hangi kanallarda çalışır?
AI ajanı, QR koduyla bağlanan WhatsApp’ta, WhatsApp Business API’de ve Telegram botunda tepki ekleyebilir.
Diğer kanallarda — kişisel Telegram, Instagram, Facebook, TikTok, MAX, LinkedIn ve web sohbeti — AnyLinga 422 reactions_not_supported döndürür. Kişisel Telegram’da Telegram işletme botlarının tepki ekleme izni yoktur.
Temsilci, ajanın tepkisini Kommo sohbetinde aynı mesaj üzerinde, bir çalışanın tepkisi gibi görür. Tepki başarıyla yansıtıldığında yanıt {"ok": true, "crm_mirrored": true} olur.
Tepki Kommo’ya yansıtılamazsa yanıtta "crm_mirrored": false bulunur. Bu durumda da tepki müşteriye gönderilmiş olur.
API yanıtları ne anlama gelir?
Tepkinin müşteriye gönderilmesi ile Kommo’da görüntülenmesini ayırt etmek için yanıt kodunu ve crm_mirrored değerini kontrol edin.
| Yanıt | Anlamı |
|---|---|
200 | Tepki müşteriye gönderildi; crm_mirrored, Kommo’da görünüp görünmediğini belirtir. |
400 | message_id bir mesaj kimliği biçiminde değil veya emoji birden fazla emoji içeriyor. |
401 | Callback belirteci geçersiz. |
404 message_not_found | Böyle bir mesaj yok veya mesaj başka bir hesaba ait. |
422 reactions_not_supported | AnyLinga bu kanalda tepki eklemeyi desteklemiyor. |
422 no_messenger_id | Mesajın mesajlaşma uygulamasında kimliği yok; tepki eklenecek bir mesaj bulunamıyor. |
502 send_failed | Mesajlaşma uygulaması tepkiyi kabul etmedi. Örneğin, emoji değeri bir emoji olmayabilir. |
Müşteri tepkisi bildirimleri nasıl etkinleştirilir?
Etkinleştirmeden önce senaryonun event alanını kontrol ettiğinden emin olun: normal müşteri mesajında bu alan bulunmaz.
1. AI ağ geçidi ayarlarını açın
- Araçlar ve ayarlar → AI ağ geçidi yolunu izleyerek Kendi yapay zekânı bağla sayfasına gidin.
2. Tepki bildirimlerini etkinleştirin
- Ağ geçidini etkinleştir anahtarının altında Müşteri tepkilerini yapay zekâya bildir seçeneğini bulun ve etkinleştirin.
- Ayar, tıkladığınız anda kaydedilir. Kaydet düğmesine tıklamanız gerekmez.
client_reaction olayı nasıl işlenir?
Müşteri tepki eklediğinde veya kaldırdığında client_reaction olayı, aynı X-AnyLinga-Signature imzasıyla aynı n8n webhook URL’si adresine gelir. Callback üzerinden yanıt vermeniz gerekmez; webhook 2xx yanıtı döndürmelidir. Anlaşma filtreleri bu olaya uygulanmaz.
Olayı müşteri mesajından event alanıyla ayırt edin. Müşterinin hangi mesaja tepki verdiğini belirlemek için message_id kullanın.
| Alan | İçeriği |
|---|---|
event | client_reaction. |
conversation_id | Görüşme. |
channel | Kanal. |
contact_id | Kommo’daki kişi veya null. |
message_id | Müşterinin tepki verdiği mesaj: gelen mesajdaki veya callback yanıtındaki kimlikle aynıdır. |
message_direction | Tepki müşterinin mesajınaysa inbound, işletmenin mesajınaysa outbound. |
emoji | Tepki emojisi. |
action | Müşteri tepki eklediyse react, kaldırdıysa unreact. |
ts | Zaman. |
unreact gelir. AnyLinga’da bulunmayan eski bir mesaja verilen tepki olay oluşturmaz.İlgili sorular
Senaryo hangi alanları alır?, AI ajanı ve temsilci aynı sohbette nasıl çalışır?, AI ajanı n8n üzerinden nasıl bağlanır?.
Sorunuz mu var?
Mesai saatlerinde yanıtlıyoruz.
Henüz hesabınız yok mu?
Kendiniz deneyin ya da ilk ayı ödediğinizde kurulumu biz yapalım.