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

RBM iş ortağı olarak kaydolduktan sonra bir iş ortağı hesabınız olur. İş ortağı hesabı ayarlarınıza erişmek için Business Communications Developer Console'u açıp İş 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 bir hizmet hesabı ve anahtar oluşturma

İş ortağı hesabı bilgilerini güncelleme

Ayarlar sayfasından 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ığı RBM 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 RBM'yi kullanımınızda doğru fatura bilgilerini oluşturmak amacıyla bu kimliği kullanır. Burada belirttiğiniz ad, operatör mesajlaşma sözleşmelerinizde kullanılan adla aynı olmalıdır.
Teknik konulardaki irtibat kişisi	Temsilcilerinizle ilgili teknik sorunlar yaşanması halinde Google'ın iletişime geçeceği kişi. 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 ayar tüm temsilcileriniz için geçerli olur. Bir müşteri temsilcisi için farklı bir webhook kullanmak istiyorsanız yalnızca bu müşteri temsilcisi için geçerli olacak bir müşteri temsilcisi webhook'u yapılandırabilirsiniz.

Markaları yönetme

RBM iş ortağı olarak markalar adına temsilciler oluşturabilirsiniz.

Marka Bir veya daha fazla temsilci tarafından temsil edilen bir kuruluş ya da grup. Örneğin, finansal hizmetler şirketi Büyüyen Ağaç, müşterilerle bankacılık hizmetleri hakkında konuşmak için Büyüyen Ağaç adlı bir marka ve Büyüyen Ağaç Bankası 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ümanlarına bakın.

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

Markayı düzenleme

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

Markaları 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. İstediğiniz düzenlemeleri yapıp Bitti'yi tıklayın.

Markayı kaldırma

Bir marka, temsilci kullanıma sunulmamış olsa bile temsilciyle ilişkiliyse kaldırılamaz.

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

Kullanıcıları yönetme

İş ortağı hesabınızın kullanıcılarını Hesap ayarları bölümündeki Kullanıcılar sayfasından 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 temsilcileri yönetmek için Geliştirici Konsolu'nun tüm özelliklerine erişebilir.
• Okuyucular, iş ortağı hesabına ait tüm temsilcileri görüntülemek için Developers 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 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ıya, artık iş ortağı hesabına erişemediğini bildiren bir e-posta gönderilir.

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 tablo satırındaki düğmesini tıklayın.
2. Rolu 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 bir hizmet hesabı anahtarıyla doğrularsınız. Bu anahtar, marka ve temsilci oluşturmanıza, yönetmenize ve temsilci olarak mesaj ve istek göndermenize olanak tanır. Bir hizmet hesabında en fazla 10 anahtar bulunabilir.

API çağrılarında güvenli kimlik doğrulaması yapmak 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 ardından Oluştur'u tıklayın. Tarayıcınız, hizmet hesabı anahtarını indirir.

Hizmet hesabı anahtarınızı güvenli ve gizli bir yerde saklayın. Anahtarınızı herkese açık olarak paylaşmayın. RBM API'lerine erişmek için daha sonra bu anahtara 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ümanlarına bakın.

Webhook, iş ortağı tarafından oluşturulan ve temsilcinizin mesajlara ve etkinliklere nasıl yanıt vereceğini belirten bir HTTPS geri çağırma işlevidir. Webhook'ınızı 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 temsilci düzeyinde bir webhook ayarlayabilirsiniz. Daha fazla bilgi için Temsilci webhook'unu 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 RBM 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. Aldığınız mesajların Google'dan geldiğini doğrulamak için bu numaraya ihtiyacınız vardır.

6. Webhook'unuzu, belirtilen clientToken parametresini içeren bir POST isteğini kabul edecek ve yanıt metni olarak secret parametresinin düz metin değerini içeren bir 200 OK yanıtı gönderecek şekilde yapılandırın.

   Örneğin, webhook'ınız aşağıdaki body içeriğine sahip bir POST isteği alırsa

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

   ise webhook'unuz clientToken değerini onaylamalı ve clientToken doğruysa yanıt gövdesinde 1234567890 bulunan 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. Developers Console'da Doğrula'yı tıklayın. RBM, webhook'ınızı doğruladığında iletişim kutusu kapanır.

Webhook teslimi hatalarını işleme ve güvenilir mesaj işleme sağlamak için İleti işleme bölümüne bakın.

Gelen iletileri doğrulama

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

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

1. İletinin X-Goog-Signature başlığını çıkarın. Bu, ileti gövdesi yükünün karma oluşturma işlemi uygulanmış ve base64 kodlu bir kopyasıdır.
2. İsteğin message.body öğesindeki RBM yükünün Base64 kodunu çözme.
3. Anahtar olarak webhook'ınızın istemci jetonunu (webhook'unuzu ayarlarken belirttiğiniz) kullanarak, base64 olarak kodu çözülmüş 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 karmayla karşılaştırın.
   • Karmalar eşleşirse mesajın Google tarafından gönderildiğini onaylamış olursunuz.

   • Karma oluşturma işlemleri eşleşmiyorsa iyi bilinen bir mesajda karma oluşturma işleminizi kontrol edin.

     Karma oluşturma işleminiz düzgün çalışıyorsa ve size sahtekarlık amaçlı 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 oluşturulduğuna göre ilk temsilcinizi oluşturmanın zamanı geldi.