İş ortağı hesabınızı oluşturun

İşletmeler için RCS iş ortağı olarak kaydolduktan sonra iş ortağı hesabınız olur. İş ortağı hesabı ayarlarınıza erişmek için İşletme İletişimleri Geliştirici Konsolu'nu açın ve İş ortağı hesabı ayarları'nı tıklayın. Buradan şunları yapabilirsiniz:

• İş ortağı hesabı bilgilerinizi güncelleme
• Hesabınıza bağlı markaları ekleme, düzenleme ve kaldırma
• Hesap kullanıcılarını yönetme
• API çağrılarının kimliğini doğrulamak için hizmet hesabı ve anahtarı oluşturma

İş ortağı hesabı bilgilerini güncelleme

Ayarlar sayfasında iş ortağı kimliğinizi görüntüleyebilir ve aşağıdaki bilgileri güncelleyebilirsiniz:

Alan	Açıklama
İş ortağının adı	İş ortağı hesabınızın adı
Görünen ad	Ad, operatörlerin aldığı faturalandırma raporlarında (owner_name alanı olarak) görünür. Operatörler, sizi güvenilir bir iş ortağı olarak tanımlamak ve abonelerine ulaşmak için RCS for Business kullanımınızla ilgili doğru faturalandırma bilgilerini oluşturmak amacıyla bu bilgileri kullanır. Burada sağladığınız ad, operatör mesajlaşma sözleşmelerinizde kullanılan adla aynı olmalıdır.
Teknik konulardaki irtibat kişisi	Temsilcilerinizle ilgili teknik sorun yaşanması halinde Google'ın iletişime geçeceği kişi. Bu kullanıcıların Ad Şirket e-posta adresi Telefon numarası
Webhook	Bu, webhook uç nokta URL'nizdir. Güncellemek için Yapılandır'ı tıklayın. İş ortağı webhook'unuzu yapılandırdığınızda, bu yapılandırma tüm temsilcilerinize uygulanır. Tek bir temsilci için farklı bir webhook kullanmak istiyorsanız yalnızca bu temsilci için geçerli olacak bir temsilci webhook'u yapılandırabilirsiniz.

Markaları yönetme

RCS Business Messaging iş ortağı olarak markalar adına temsilciler oluşturabilirsiniz.

Marka Bir veya daha fazla temsilci tarafından temsil edilen kuruluş ya da grup. Örneğin, Growing Tree adlı finansal hizmetler şirketi, bankacılık hizmetleri hakkında müşterilerle konuşmak için Growing Tree adlı bir marka ve Growing Tree Bank adlı bir temsilci oluşturabilir.

İş ortağı hesabınızla ilişkili markaları eklemek, düzenlemek ve kaldırmak için Hesap ayarları bölümündeki Markalar sayfasını kullanın.

Marka ekleyin

Not: RBM Management API'yi kullanarak marka eklemek için Marka oluşturma dokümanına bakın.

Marka eklemek için giriş alanına markanın adını girip Ekle'yi tıklayın.

Marka düzenleme

Not: RBM Management API'yi kullanarak bir markayı düzenlemek için Markayı yeniden adlandırma dokümanlarına bakın.

Bir markayı düzenlemek için:

1. Markanın adının yanındaki onay kutusunu tıklayın.
2. düğmesini ve Adı düzenle'yi tıklayın.
3. Düzenlemelerinizi yapıp Bitti'yi tıklayın.

Markayı kaldırma

Bir temsilciyle ilişkili olan markalar, temsilci başlatılmamış olsa bile kaldırılamaz.

Bir markayı kaldırmak için markanın adının yanındaki onay kutusunu işaretleyin ve Sil'i tıklayın.

Kullanıcıları yönetme

Hesap ayarları bölümündeki Kullanıcılar sayfasında iş ortağı hesabınızın kullanıcılarını yönetebilirsiniz. İş ortağı hesabını oluşturan kullanıcı, Sahip rolüne sahiptir. Yeni kullanıcılar yönetici veya okuyucu rolüne sahip olabilir.

• Yöneticiler, iş ortağı hesabına ait tüm aracıları yönetmek için Geliştirici Konsolu'nun tüm özelliklerine erişebilir.
• Okuyucular, iş ortağı hesabına ait tüm aracıları görüntülemek için Developer Console'a salt okuma erişimine sahiptir.

Kullanıcı ekleme

Kullanıcı eklemek için giriş alanına kullanıcının e-posta adresini girin ve Rol'ünü seçin.

Yeni bir kullanıcı eklediğinizde, bu kullanıcıya iş ortağı hesabına erişimi olduğunu bildiren bir e-posta gönderilir.

Bir kullanıcıyı kaldırabilir

Bir kullanıcıyı kaldırmak için:

1. Kaldırmak istediğiniz kullanıcıyı bulun ve kullanıcının tablo satırındaki düğmesini tıklayın.
2. Kullanıcıyı kaldır'ı seçin.
3. Kaldırma işlemini onaylayın.

Kaldırdığınız kullanıcı, artık iş ortağı hesabına erişimi olmadığını bildiren bir e-posta alır.

Sahip rolüne sahip bir kullanıcıyı kaldıramazsınız. Sahibi değiştirmek veya kaldırmak için destek ekibiyle iletişime geçmeniz gerekir.

Kullanıcıların rollerini değiştirme

Bir kullanıcının rolünü güncellemek için:

1. Güncellemek istediğiniz kullanıcıyı bulun ve kullanıcının tablo satırındaki düğmesini tıklayın.
2. Rolü düzenle'yi seçin.
3. Açılır listeden yeni bir rol seçin.
4. Kaydet'i tıklayın.

API çağrılarının kimliğini doğrulamak için hizmet hesabı oluşturma

RBM API'ye çağrı yaptığınızda, çağrıların kimliğini hizmet hesabı anahtarıyla doğrulayın. Bu anahtar, marka ve temsilci oluşturup yönetmenize, ayrıca temsilci olarak mesaj ve istek göndermenize olanak tanır. Bir hizmet hesabında en fazla 10 anahtar bulunabilir.

API çağrılarının güvenli bir şekilde kimliğinin doğrulanması için oauth2l komut satırı aracına da ihtiyacınız vardır.

Hizmet hesabı anahtarı oluşturmak için aşağıdaki adımları uygulayın:

1. Hesap ayarları bölümünde Hizmet hesabı sayfasına gidin.
2. Anahtar oluştur'u ve Oluştur'u tıklayın. Tarayıcınız, hizmet hesabı anahtarını indirir.

Hizmet hesabı anahtarınızı güvenli ve özel bir konumda saklayın. Anahtarınızı herkese açık olarak paylaşmayın. RBM API'lerine erişmek için bu anahtara daha sonra ihtiyacınız olacak.

İş ortağı webhook'unuzu yapılandırma

Not: İş ortağı webhook'unuzu API'yi kullanarak yapılandırmak için Webhook entegrasyonu oluşturma dokümanına bakın.

Webhook, iş ortağı tarafından oluşturulan bir HTTPS geri aramasıdır. Bu geri arama, temsilcinizin mesajlara ve etkinliklere nasıl yanıt vermesi gerektiğini belirtir. Webhook'unuzu yapılandırdıktan sonra mesaj ve etkinlik almaya başlayabilirsiniz.

Temsilcilerinizden herhangi biri için farklı bir webhook kullanmak istiyorsanız iş ortağı webhook'unu geçersiz kılacak bir temsilci düzeyinde webhook ayarlayabilirsiniz. Daha fazla bilgi için Aracı webhook'u yapılandırma başlıklı makaleyi inceleyin.

İş ortağı webhook'unuzu yapılandırmak için aşağıdaki adımları uygulayın:

1. Business Communications Developer Console'u açın ve İş için RCS iş ortağı Google Hesabınızla oturum açın.

2. Hesap ayarları'nı açın.

3. RCS Business Messaging webhook URL'si için Yapılandır'ı tıklayın.

4. Webhook uç nokta URL'si alanına "https://" ile başlayan webhook URL'nizi girin.

5. clientToken değerinizi not edin. Bu kod, aldığınız iletilerin Google'dan geldiğini doğrulamanız için gereklidir.

6. Webhook'unuzu, belirtilen clientToken parametresiyle bir POST isteğini kabul edecek şekilde yapılandırın ve yanıt gövdesi olarak secret parametresinin düz metin değeriyle bir 200 OK yanıtı gönderin.

   Örneğin, webhook'unuz aşağıdaki gövde içeriğine sahip bir POST isteği alıyorsa

   {
     "clientToken":"SJENCPGJESMGUFPY",
     "secret":"1234567890"
   }
   

   ise webhook'unuz clientToken değerini onaylamalı ve clientToken doğruysa yanıt gövdesi olarak 1234567890 ile birlikte bir 200 OK yanıtı döndürmelidir:

   // clientToken from Configure
   const myClientToken = "SJENCPGJESMGUFPY";
   
   // Example endpoint
   app.post("/rbm-webhook", (req, res) => {
     const msg = req.body;
     if (msg.clientToken === myClientToken) {
         res.status(200).send(msg.secret);
         return;
     }
     res.send(400);
   });
   

7. Geliştirici Konsolu'nda Doğrula'yı tıklayın. İşletmeler için RCS, webhook'unuzu doğruladığında iletişim kutusu kapanır.

Teslimat hatalarını önlemek için webhook'ları eşzamansız olarak işleme konusunda yardım almak istiyorsanız İleti işleme başlıklı makaleyi inceleyin.

Gelen iletileri doğrulama

Webhook'lar herhangi bir gönderenden mesaj alabileceğinden, mesaj içeriğini işlemeden önce gelen mesajların Google tarafından gönderildiğini doğrulamanız gerekir.

Google'ın gönderdiği bir mesajı aldığınızı doğrulamak için aşağıdaki adımları uygulayın:

1. İletinin X-Goog-Signature başlığını ayıklayın. Bu, ileti gövdesi yükünün karma oluşturma algoritması uygulanmış, base64 kodlu bir kopyasıdır.
2. İsteğin message.body öğesindeki RBM yükünün Base64 kodunu çözün.
3. Webhook'unuzun istemci jetonunu (webhook'unuzu ayarlarken belirttiğiniz) anahtar olarak kullanarak, base64 kodlu mesaj yükünün baytlarının SHA512 HMAC'sini oluşturun ve sonucu base64 ile kodlayın.
4. X-Goog-Signature karmasını oluşturduğunuz karma ile karşılaştırın.
   • Karma değerleri eşleşirse Google'ın mesajı gönderdiğini onaylamış olursunuz.

   • Karma değerler eşleşmiyorsa karma oluşturma işleminizi bilinen iyi bir mesaj üzerinde kontrol edin.

     Karma oluşturma işleminiz doğru şekilde çalışıyorsa ve size sahtekarlık amacıyla gönderildiğini düşündüğünüz bir mesaj alırsanız bize ulaşın.

Node.js

  if ((requestBody.hasOwnProperty('message')) && (requestBody.message.hasOwnProperty('data'))) {
    // Validate the received hash to ensure the message came from Google RBM
    let userEventString = Buffer.from(requestBody.message.data, 'base64');
    let hmac = crypto.createHmac('sha512', CLIENT_TOKEN);
    let data = hmac.update(userEventString);
    let genHash = data.digest('base64');
    let headerHash = req.header('X-Goog-Signature');

    if (headerHash === genHash) {
      let userEvent = JSON.parse(userEventString);

      console.log('userEventString: ' + userEventString);
      handleMessage(userEvent);
    } else {
      console.log('hash mismatch - ignoring message');
    }
  }

  res.sendStatus(200);
  

Sonraki adımlar

İş ortağı hesabınız ayarlandığına göre artık ilk temsilcinizi oluşturabilirsiniz.