İlk temsilcinizi oluşturun

Kullanıcılar, cihazlarındaki Google Mesajlar gibi RCS özellikli bir mesajlaşma uygulaması üzerinden temsilcilerle etkileşim kurar. Bu hızlı başlangıç kılavuzunda, bir test cihazına basit bir mesaj gönderip yanıt alabilen temel bir RBM aracısı oluşturacaksınız.

Ön koşullar

Temsilcinizi kullanmaya başlamadan önce aşağıdakilere ihtiyacınız vardır:

• Temsilcinizin temsil edeceği markanın adı
• Temsilcinizi arayın
  • Ad
  • Temsilcinin çalışacağı bölge
  • Faturalandırma kategorisi
  • Kullanım alanı
• Etkin bir telefon numarasına sahip Android cihaz
• Örnek kod çalıştırabilen bir geliştirme makinesi

Test cihazınızı kurma

Henüz kullanıma sunulmamış bir RBM aracısıyla iletişim kurmak için test cihazının RCS'yi desteklemesi gerekir. Ancak tüm Android cihazlar varsayılan olarak RCS mesajlarını alamaz. Cihazınızı Mesajlar ve Carrier Services uygulamalarının ön sürümleriyle yapılandırarak cihazınızın RCS durumunu kontrol edebilir ve gerekirse RCS'yi etkinleştirebilirsiniz.

Cihazınızın RCS durumunu kontrol etme

1. Mesajlar uygulamasında more_vert düğmesine, ardından Ayarlar'a dokunun.

2. Sohbet özellikleri'ne dokunup Durum değerini bulun.

   Durum Bağlı ise RCS cihazınızda etkindir.

Sonraki adımlar

Cihazınızda RCS etkinse temsilcinizi ayarlamaya hazırsınız demektir. Cihazınızda RCS etkin değilse RBM aracınızı test edebilmek için cihazınızda RCS'yi etkinleştirmeniz gerekir.

Temsilcinizi ayarlama

RBM temsilcileri, kullanıcılara mesaj, etkinlik ve diğer istekler göndermek için RBM API'yi kullanır. Temsilci oluşturduğunuzda RBM API'ye erişimi etkinleştirir ve temsilcinizin temel bilgilerini tanımlarsınız.

Temsilcinin bölgesini belirleme

RBM aracıları üç bölgeden birinde bulunabilir: Kuzey Amerika, Avrupa ve Asya Pasifik. RBM API, işletmelerin bölgesel ve ticari şartlara uymasına yardımcı olmak için üç bölgesel uç noktayı destekler.

Temsilcinizi oluştururken geçerli düzenlemelere, şartlara ve son kullanıcılara yakınlığa göre temsilcinizin bölgesini seçin. Bu bölge, temsilcinizin nereden çalıştığını ve verilerini nerede depoladığını belirler.

Siz veya hedeflediğiniz kullanıcılar bu bölgelere uymuyorsa gecikmeyi en aza indirmek için size en yakın bölgeyi seçin. Örneğin:

• Latin Amerika'da ikamet ediyorsanız Kuzey Amerika bölgesini seçin.
• Afrika'da ikamet ediyorsanız Avrupa bölgesini seçin.
• Avustralya'da ikamet ediyorsanız Asya Pasifik bölgesini seçin.

Temsilcinizin bölgesine hedef kargo şirketlerinize göre karar vermeyin. Tüm bölgeler, dünya genelindeki operatörlere eşit erişime sahiptir.

Temsilcinin faturalandırma kategorisini belirleme

RBM temsilcisi oluştururken, temsilcinin kullanıcılarla nasıl etkileşimde bulunacağına bağlı olarak faturalandırma kategorisini belirtmeniz gerekir. Temsilcinizin amaçladığı davranışa en yakın kategoriyi seçin:

• Sohbet: Kullanıcılarla çoklu turlu görüşmeler yapan temsilciler için.
• Temel Mesaj veya Tek Mesaj: Sık sık yanıt almayı beklemeden mesaj gönderen temsilciler için.

Temsilcinizi yalnızca kullanıma sunmadan önce faturalandırma kategorisini değiştirebilirsiniz. Lansmandan sonra faturalandırma kategorisini değiştirmeniz gerekiyorsa [email protected] adresine e-posta gönderin.

RBM faturalandırma modeli hakkında daha fazla bilgi için RBM faturalandırması ile ilgili SSS başlıklı makaleyi inceleyin.

Temsilcinin kullanım alanını belirleyin

Her RBM temsilcisinin önceden tanımlanmış bir kullanım alanına sahip olması gerekir. Bu, temsilcinizi kategorize etmenize ve iyi bir kullanıcı deneyimi için doğru işletme kurallarını uygulamanıza yardımcı olur. RBM dört kullanım alanını destekler:

• OTP: Hesabın kimliğini güvenli bir şekilde doğrulamak veya bir işlemi onaylamak için gereken tek kullanımlık şifreler.
• İşlemsel: Şüpheli hesap etkinlikleri uyarıları, satın alma onayları ve gönderim bildirimleri gibi müşterinin mevcut hizmetleriyle veya ürünleriyle doğrudan alakalı bilgileri paylaşan bildirimler, güncellemeler veya uyarılar.
• Tanıtım amaçlı: Bilinirliği, etkileşimi ve satışları artırma amacıyla yeni veya mevcut müşterilere yönelik satış, pazarlama ve tanıtım amaçlı mesajlar.
• Çoklu kullanım: İşlemsel ve tanıtım amaçlı mesajları birleştiren görüşmeler (ör. hesap bildirimi gönderdikten sonra indirim teklifi sunma veya yeni bir ürüne ya da hizmete geçme).

Her kullanım alanında, gönderebileceğiniz içeriklerle ilgili farklı kurallar vardır. Her kullanım alanı hakkında daha fazla bilgi edinmek ve temsilciniz için en uygun seçeneği bulmak istiyorsanız Temsilciniz için doğru kullanım alanını seçme başlıklı makaleyi inceleyin.

Temsilcinizi kullanıma sunmak için gönderdikten sonra kullanım alanını değiştiremezsiniz. Temsilcinizi göndermeden önce ülkenizin kullanım alanlarını ve iş kurallarını kontrol edin.

Aracı oluşturma

Business Communications Developers Console'da temsilcinizi oluşturmak için aşağıdaki talimatları uygulayın.

Temsilci oluşturmak için:

1. Business Communications Developer Console'a gidin ve RBM iş ortağı Google Hesabınızla oturum açın.
2. Ana sayfada + Temsilci oluştur'u tıklayın.
3. Yeni RCS Business Messaging temsilcisi penceresinde aşağıdaki bilgileri belirtin:
   • Temsilcinizin temsil ettiği marka
   • Temsilci adı
   • Barındırma bölgesi
   • Faturalandırma kategorisi
   • Kullanım alanı
4. Temsilci oluştur'u tıklayın.

Temsilciniz müsait olduğunda işletme ve marka bilinci oluşturma bilgileri ekleyebilirsiniz. Temsilcinizi oluşturma başlıklı makaleyi inceleyin.

Test cihazınızı davet etme

Bir temsilciniz olduğu ve test cihazınız RCS özellikli olduğu için cihazınızı davet ederek temsilcinizi test edebilirsiniz.

1. Soldaki gezinme menüsünden Cihazlar'ı tıklayın.
2. Test cihazı ekle bölümünde cihazınızın telefon numarasını girin ve Ekle'yi tıklayın.
3. Test cihazınızda, temsilciniz için test kullanıcısı isteğini kabul edin.

Test cihazınızda davetiye almazsanız cihazınızda RCS'nin etkinleştirildiğinden emin olun.

Mesaj gönder

Kayıtlı bir test cihazıyla temsilciniz artık mesaj gönderebilir.

API çağrılarında güvenli bir şekilde kimlik doğrulaması yapmak için bir hizmet hesabı anahtarına ihtiyacınız vardır. İş ortağı hesabınız için hizmet hesabı anahtarı oluşturmadıysanız şimdi tam zamanı.

Geliştirme makinenizdeki bir terminalde aşağıdaki komutu çalıştırın:

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  }
}'

• Temsilcinizin bölgesine bağlı olarak REGION yerine asia, europe veya us yazın.
• PHONE_NUMBER yerine test cihazınızın telefon numarasını yazın. Ülke kodunu, alan kodunu ve + karakterini ekleyin ancak ayırıcı karakter eklemeyin. Örneğin, +14155555555.
• AGENT ID değerini, Business Communications Developer Console'daki Temsilci bilgileri sayfasında bulunan temsilci kimliğinizle değiştirin.
• PATH_TO_SERVICE_ACCOUNT_KEY yerine daha önce oluşturduğunuz anahtarın yolunu girin.

Test cihazınızda temsilcinizden "Merhaba Dünya" mesajı alırsınız. Test cihazınızda mesaj almazsanız komutta telefon numarasını ve hizmet hesabı anahtarınızın yolunu doğru şekilde girip biçimlendirdiğinizden emin olun.

Önerilen yanıtlar ve zengin kartlar gibi farklı mesaj türleri göndermek için Mesaj gönderme başlıklı makaleyi inceleyin.

Sonraki adımlar

Temsilciniz bir test cihazına mesaj gönderebildiğine göre, işletmenizin ihtiyaçlarına uygun bir şey oluşturmanın zamanı geldi. Tercih ettiğiniz dilde bir örnek aracı edinin ve örneğin README dosyasında yer alan talimatları uygulayın.

Örnek temsilciyi yapılandırdıktan sonra RBM'nin en iyi uygulamalarını inceleyin ve temsilcilerin mesajları nasıl gönderdiğini ve aldığını öğrenin.