Temsilciniz, RBM platformundan webhook etkinlikleri alır. Bu etkinlikler, kullanıcı etkileşimleri ve platform düzeyindeki güncellemeler hakkında sizi bilgilendirir.
Bu etkinlikler, kaynaklarına göre kategorilere ayrılır:
- Kullanıcı etkinlikleri: Kullanıcının cihazından temsilcinize gönderilen ve temsilcinizle etkileşimi belirten bildirimler.
- Platform etkinlikleri: RBM platformu tarafından gönderilen, temsilci lansman durumu değişiklikleri ve mesajların geçerlilik süresinin dolmasıyla ilgili bildirimler.
Temsilcinizin kullanıcının cihazına gönderdiği durum etkinlikleri hakkında ayrıntılı bilgi için Etkinlik gönderme başlıklı makaleyi inceleyin.
Metin, dosya, konum ve diğer kullanıcı mesajlarının nasıl işleneceğiyle ilgili ayrıntılar için Mesaj alma başlıklı makaleyi inceleyin.
Kullanıcı etkinlikleri
Kullanıcı etkinlikleri, kullanıcının cihazından gelen ve mesaj durumunu veya abonelik değişikliklerini (ör. kullanıcının Google Mesajlar'da abonelikten çıktığını veya yeniden abone olduğunu) bildiren bildirimlerdir.
Tüm biçimlendirme ve değer seçenekleri için UserEvent referansına bakın.
Kullanıcı, temsilcinin mesajını alır
Bu etkinlik, bir mesajın kullanıcının cihazına başarıyla teslim edildiğini gösterir.
{
"senderPhoneNumber": "PHONE_NUMBER",
"eventType": "DELIVERED",
"eventId": "EVENT_ID",
"messageId": "MESSAGE_ID",
"agentId": "AGENT_ID"
}Kullanıcı, temsilcinin mesajını okur
Bu etkinlik, bir mesajın açıldığını veya onaylandığını gösterir.
{
"senderPhoneNumber": "PHONE_NUMBER",
"eventType": "READ",
"eventId": "EVENT_ID",
"messageId": "MESSAGE_ID",
"agentId": "AGENT_ID"
}Kullanıcı yazmaya başlar
Bu etkinlik, bir kullanıcının yanıt yazdığını gösterir.
{
"senderPhoneNumber": "PHONE_NUMBER",
"eventType": "IS_TYPING",
"eventId": "EVENT_ID",
"agentId": "AGENT_ID"
}Kullanıcı önerilen bir işleme dokunduğunda
Kullanıcı önerilen bir işleme dokunduğunda temsilciniz, işlemin geri gönderme verilerini içeren bir etkinlik alır.
{
"senderPhoneNumber": "PHONE_NUMBER",
"eventId": "EVENT_ID",
"agentId": "AGENT_ID",
"suggestionResponse": {
"postbackData": "postback_1234"
}
}Kullanıcı, görüşmenin e-posta listesinden çıkarsa
Bu etkinlik, kullanıcının temsilcinizden ve temsil ettiği işletmeden promosyonlar gibi gerekli olmayan mesajları alma aboneliğinden çıktığını gösterir. Kullanıcılar, Google Mesajlar'da RBM görüşmesinin aboneliğinden çıkarak bu etkinliği tetikler.
JSON yükü örneğini aşağıda bulabilirsiniz:
{
"senderPhoneNumber": "PHONE_NUMBER",
"eventType": "UNSUBSCRIBE",
"eventId": "EVENT_ID",
"agentId": "AGENT_ID"
}Abonelikten çıkma özelliğinin işleyiş şekli
- Sohbet menüsünde her zaman Abonelikten çık seçeneği bulunur. Tanıtım amaçlı ve çok amaçlı temsilcilerde bu seçenek, belirli sayıda okunmamış mesajdan sonra doğrudan sohbette de görünür (belirli kurallar ülkeye göre değişir).
Abonelikten çık'ı seçtiğinizde aynı anda iki işlem tetiklenir: Google Mesajlar, temsilcinize ülkeye özgü bir anahtar kelime (ör. "STOP") gönderir ve RBM platformu, webhook'unuza bir
UNSUBSCRIBEetkinliği gönderir.Anahtar kelime, kullanıcının telefon numarasının iki harfli ülke koduyla belirlenir. Aşağıdaki tabloda, desteklenen her ülke için anahtar kelimeler listelenmiştir.
Ülke (ülke kodu) Abonelikten çıkma anahtar kelimesi ABD (US), Almanya (DE), Birleşik Krallık (GB), Hindistan (IN), Hollanda (NL) DURDUR İspanya (ES), Meksika (MX) BAJA Fransa (FR) STOP Brezilya (BR) parar Kullanıcı e-posta listesinden çıktıktan sonra, spam olarak bildirilmediği sürece görüşme gelen kutusunda kalır. Spam olarak bildirilen görüşmeler ise Spam ve engellenenler klasörüne taşınır.
Google, politika ve iş kuralı ihlallerini tespit etmek için kullanıcı abonelikten çıktıktan sonra mesaj kalıplarını izler.
İş kuralları
- Bu görüşmeyi yöneten RBM iş ortağı olarak, kullanıcının abonelikten çıkma isteğini yerine getirmek sizin sorumluluğunuzdadır.
- Abonelikten çıkma işlemini mesaj dizisinde gerçekleştiremiyorsanız kullanıcıların abonelik tercihlerini yönetebileceği web sitesine veya uygulamaya doğrudan bağlantı içeren bir onay mesajını hemen göndermeniz gerekir.
- Kullanıcı abonelikten çıktıktan sonra gerekli olmayan mesajların gönderilmesi yasaktır.
- Önemli mesajlara izin verilir. Bunlardan bazıları:
- Tek kullanımlık şifreler (OTP) gibi kimlik doğrulama bilgileri
- Kullanıcının talep ettiği ve onay verdiği belirli bir hizmetle ilgili bildirimler
- Kullanıcının e-posta listesinden çıkma isteğinin onayı ve iletişim tercihlerini daha ayrıntılı şekilde yönetebileceği bilgiler
Örnek
Kullanım alanı çoklu kullanım olan bir hava yolu şirketinin temsilcisinin aboneliğinden çıkan kullanıcılara pazarlama mesajları göndermeyi durdurmanız gerekir. Ancak kullanıcı, belirli bir uçuşla ilgili güncellemeleri almak için açıkça izin verdiyse uçuş güncellemeleri gönderebilirsiniz.
Abonelikten çıkma nedenleri
Kullanıcılar, temsilcinizin aboneliğinden çıkarken aşağıdaki seçeneklerden birini belirleyebilir:
- Çok sayıda mesaj alıyorum
- Buna hiç kaydolmadım
- Artık ilgimi çekmiyor
- Dolandırıcılık girişimi gibi görünüyor
- Diğer
Seçim yanlılığını azaltmak için ilk dört seçenek her kullanıcıya rastgele bir sırayla gösterilir. Bu sıralama, kullanıcının ziyaretleri boyunca tutarlı kalır ve Diğer seçeneği en altta sabit kalır.
E-posta listesinden çıkma nedenleri, kullanıcıların e-posta listesinden çıkma nedenlerini anlamanıza yardımcı olmak için toplanır ve Analytics'e genel bakış bölümünde gösterilir.
Kullanıcı görüşmeye yeniden abone olur.
Bu etkinlik, bir kullanıcının temsilcinizden tekrar mesaj (promosyonlar gibi gerekli olmayan içerikler dahil) almak istediğini gösterir. Kullanıcılar, Google Mesajlar'da daha önce abonelikten çıktıkları bir görüşmeye yeniden abone olarak bu etkinliği tetikleyebilir.
JSON yükü örneğini aşağıda bulabilirsiniz:
{
"senderPhoneNumber": "PHONE_NUMBER",
"eventType": "SUBSCRIBE",
"eventId": "EVENT_ID",
"agentId": "AGENT_ID"
}Yeniden abone olma özelliğinin işleyiş şekli
- Hem sohbet menüsünde hem de sohbet içi bağlantıda bulunan Abone ol seçeneği, kullanıcıların abonelikten çıktıkları bir görüşmeye yeniden abone olmalarına olanak tanır.
Abone ol'u seçtiğinizde aynı anda iki işlem tetiklenir: Google Mesajlar, temsilcinize ülkeye özgü bir anahtar kelime (ör. "BAŞLAT") gönderir ve RBM platformu, webhook'unuza bir ABONE OL etkinliği gönderir. Belirli anahtar kelime, kullanıcının telefon numarasının iki harfli ülke koduna göre belirlenir. Aşağıdaki tabloda, desteklenen her ülke için anahtar kelimeler listelenmiştir.
Ülke (ülke kodu) Abone ol anahtar kelimesi ABD (US), Almanya (DE), Birleşik Krallık (GB), Hindistan (IN), Hollanda (NL) BAŞLAT İspanya (ES), Meksika (MX) ALTA Fransa (FR) Démarrer Brezilya (BR) começar
İş kuralları
- Bu görüşmeyi yöneten RBM iş ortağı olarak, kullanıcının yeniden abone olma isteğini yerine getirmek sizin sorumluluğunuzdadır.
- Yeniden abone olma, tanıtımlar gibi gerekli olmayan içerikler de dahil olmak üzere tüm mesaj türleri için geçerlidir.
- Bir kullanıcı, abonelikten çıktıktan sonra işletmenize mesaj gönderirse bu, yeniden abone olma isteği olarak kabul edilebilir.
- Kullanıcı, mesajlaşma kanalının dışından (ör. web sitenizden) yeniden abone olursa durumunu güncellemek ve buna göre mesaj göndermeye devam etmek RBM iş ortağı olarak sizin sorumluluğunuzdadır.
Platform etkinlikleri
RBM platformu, temsilcinizin lansman durumundaki değişiklikler veya mesajların geçerlilik sürelerinin dolması hakkında temsilcinizi bilgilendirmek için platform etkinlikleri gönderir.
Temsilci başlatma durumu değişti
RBM platformu, temsilcinizin lansman durumundaki her değişiklik için bir AgentLaunchEvent gönderir. Örneğin, temsilcinizin durumu PENDING iken LAUNCHED olarak değiştiğinde. Etkinlik, Pub/Sub mesajı olarak yayınlanır. Bu etkinliği diğerlerinden ayırt etmek için message.attributes.type yolunda agent_launch_event değerini kontrol edin.
Webhook yapılandırması
Bu bildirimleri almak için iş ortağı düzeyinde veya temsilci düzeyinde webhook'unuzu kullanabilirsiniz.
Ön koşullar
- RBM mesajlaşması için webhook'unuzu yapılandırın (Bu, kullanıcı mesajlarını ve kullanıcı etkinliklerini almak için gereklidir).
- Kullanıcı etkinlikleri ile temsilci başlatma durumu etkinliklerini ayırt etmek için
message.attributes.typeyolundaagent_launch_eventdeğerini kontrol edin.
Etkinlik yükü yapısı
AgentLaunchEvent, Pub/Sub mesajı olarak yayınlanır.
Aşağıda bununla ilgili bir örnek verilmiştir:
{
"message": {
"attributes": {
"business_id": "rbm-chatbot-id@rbm.goog",
"event_type": "REJECTED",
"product": "RBM",
"project_number": "3338881441851",
"type": "agent_launch_event"
},
"data": "....BASE64-encoded-JSON-with-notification...",
"messageId": "14150481888479752",
"message_id": "14150481888479752",
"publishTime": "2025-03-05T18:50:21.88Z",
"publish_time": "2025-03-05T18:50:21.88Z"
},
"subscription": "projects/rbm-partner-gcp/subscriptions/rbm-sub"
}
Etkinlik yükündeki AgentLaunchEvent.LaunchState alanı, temsilcinin yeni başlatma durumunu gösterir. Olası değerler şunlardır:
| Değer | Temsilci başlatma durumu | Ayrıntılar |
|---|---|---|
PENDING |
Beklemede | İstek, incelenmek üzere bir operatöre gönderildi. |
LAUNCHED |
Başlatıldı | Belirli bir operatörde mesajlara izin verilir. |
REJECTED |
Belirli bir operatör tarafından reddedildi | Ret nedeni yorumda belirtilir. |
SUSPENDED |
Belirli bir operatörde askıya alındı | Askıya alma nedeni yorumda belirtilir. |
UNLAUNCHED |
Başlatılmadı | Tüm operatörlerde devre dışı bırakılan temsilciler düzenlenebilir. |
Veri alanı, başlatma durumu ayrıntılarını içeren Base64 kodlu bir JSON nesnesi içerir. Kodu çözülmüş JSON örneğini aşağıda bulabilirsiniz:
{
"eventId": "rbm-chatbot-id/0a7ed168-676e-4a56-b422-b23434",
"agentId": "rbm-chatbot-id@rbm.goog",
"botDisplayName": "RBM Welcome Bot 7 - RBM Chatbot name",
"brandId": "bd38fbff-392a-437b-a6f2-7f2e43745b56",
"brandDisplayName": "Chatbots brand",
"regionId": "/v1/regions/fi-rcs",
"oldLaunchState": "PENDING",
"newLaunchState": "REJECTED",
"actingParty": "rbm-support@google.com",
"comment": "Carrier has rejected the launch: policy violation",
"sendTime": "2025-03-05T18:50:19.386436Z"
}
Operatör tarafından başlatılan lansman durumu değişiklikleri
Bunlar, inceleme ve yaptırım süreci sırasında genellikle operatörler tarafından gerçekleştirilen izin verilen geçişlerdir:
| Eski başlatma durumu | Yeni lansman durumu | Tetikleyici işlemi |
|---|---|---|
PENDING |
LAUNCHED |
Lansman isteğini onaylama |
PENDING |
REJECTED |
Lansman isteğini reddetme |
LAUNCHED |
SUSPENDED |
Yaptırım/yönetici nedenleriyle askıya alma. |
SUSPENDED |
LAUNCHED |
Bir temsilciyi etkin duruma geri yükleme |
SUSPENDED |
UNLAUNCHED |
Bir temsilciyi sonlandırma |
REJECTED |
LAUNCHED |
Daha önce reddedilen bir lansman isteğini onaylama |
İş ortağı tarafından başlatılan lansman durumu değişiklikleri
Bunlar, genellikle iş ortakları tarafından gerçekleştirilen izin verilen geçişlerdir:
| Eski başlatma durumu | Yeni lansman durumu | Tetikleyici işlemi |
|---|---|---|
UNSPECIFIED |
PENDING |
İncelemeye gönderin. |
PENDING |
UNLAUNCHED |
Beklemedeki bir lansman isteğini iptal etme |
UNLAUNCHED |
PENDING |
İncelemeye gönderin. |
REJECTED |
PENDING |
İnceleme için yeniden gönderin. |
SUSPENDED |
PENDING |
İnceleme için yeniden gönderin. |
Mesajın süresi doldu; iptal işlemi başarılı oldu
Bu etkinlik, mesajın geçerlilik süresinin (TTL) dolduğunu ve mesajın başarıyla iptal edildiğini gösterir. Bu, yedek mesajlaşma stratejiniz için iyi bir tetikleyicidir.
Tüm biçimlendirme ve değer seçenekleri için ServerEvent referansına bakın.
{
"phoneNumber": "PHONE_NUMBER",
"messageId": "MESSAGE_ID",
"agentId": "AGENT_ID",
"eventType": "TTL_EXPIRATION_REVOKED",
"eventId": "EVENT_ID",
"sendTime": "TIMESTAMP"
}Mesajın süresi doldu; iptal işlemi başarısız oldu
Bu etkinlik, iletinin TTL'sinin sona erdiğini ancak başarılı bir şekilde iptal edilmediğini gösterir.
Tüm biçimlendirme ve değer seçenekleri için ServerEvent referansına bakın.
{
"phoneNumber": "PHONE_NUMBER",
"messageId": "MESSAGE_ID",
"agentId": "AGENT_ID",
"eventType": "TTL_EXPIRATION_REVOKE_FAILED",
"eventId": "EVENT_ID",
"sendTime": "TIMESTAMP"
}Mesajın teslim edileceği garanti edilmez.
- Mesaj teslim edildiyse webhook'unuzda bir
DELIVEREDetkinliği alırsınız. - İleti teslim edilmediyse iptal isteği göndermek için iptal API'sini kullanın.
Mesaj, OTP veya sahtekarlık uyarısı gibi zamana duyarlıysa kullanıcıya yinelenen mesajlar gönderilmesine neden olsa bile mesajı SMS gibi alternatif bir kanal üzerinden göndermek en iyisidir.