İş 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 İş İletişimleri Geliştirici Konsolu'nu açın ve İş ortağı hesabı ayarları'nı tıklayın. Buradan aşağıdakileri yapabilirsiniz:

İş 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ığı RBM faturalandırma raporlarında (owner_name alanı olarak) görünür. Operatörler bu bilgileri, sizi güvenilir bir iş ortağı olarak tanımlamak ve abonelerine ulaşmak amacıyla RBM kullanımınızla ilgili doğru fatura bilgilerini oluşturduklarından emin olmak için kullanır. Burada sağladığınız ad, operatör mesajlaşma sözleşmelerinizde kullanılan adla uyumlu olmalıdır.
Teknik konulardaki irtibat kişisi

Temsilcilerinizle ilgili teknik sorun yaşadığınızda Google'ın iletişim kuracağı kişi. 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 aracı için farklı bir webhook kullanmak isterseniz yalnızca söz konusu aracı için geçerli olacak bir aracı webhook yapılandırabilirsiniz.

Markaları yönetme

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

İş ortağı hesabınızla ilişkilendirilmiş markaları eklemek, düzenlemek ve kaldırmak için Hesap ayarları'ndaki Markalar sayfasını kullanın.

Marka ekleyin

Bir marka eklemek için giriş alanına markanın adını girin ve Ekle'yi tıklayın.

Markayı düzenleme

Bir markayı düzenlemek için:

  1. Marka adının yanındaki onay kutusunu tıklayın.
  2. düğmesini ve ardından Adı düzenle'yi tıklayın.
  3. İstediğiniz düzenlemeleri yapıp Bitti'yi tıklayın.

Marka kaldırma

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

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

Kullanıcıları yönetme

Hesap ayarlarındaki Kullanıcılar sayfası, iş ortağı hesabınızın kullanıcılarını yönettiğiniz yerdir. İş ortağı hesabını oluşturan kullanıcı Sahip rolündedir. Yeni kullanıcılar Yönetici veya Okuyucu rolüne sahip olabilirler.

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

Kullanıcı ekleyin

Bir kullanıcı eklemek için giriş alanına kullanıcının e-posta adresini girin ve Rol öğesini seçin.

Yeni kullanıcı eklediğinizde, eklediğiniz kullanıcılara iş ortağı hesabına erişebildiğini bildiren bir e-posta gönderilir.

Kullanıcıları kaldırma

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şemediğini bildiren bir e-posta alır.

Sahip rolüne sahip bir kullanıcıyı kaldıramazsınız. Sahip rolünü 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ı bir hizmet hesabı anahtarıyla doğrularsınız. Bu anahtar, marka ve aracı oluşturup yönetmenize ve temsilci olarak mesaj ve istek göndermenize olanak tanır.

Hizmet hesabı anahtarı oluşturmak için şu adımları uygulayın:

  1. Hesap ayarları'nda Hizmet hesabı sayfasına gidin.
  2. Create key (Anahtar oluştur) ve ardından Create (Oluştur) seçeneğini tıklayın. Tarayıcınız hizmet hesabı anahtarını indirir.

Hizmet hesabı anahtarınızı güvenli ve gizli bir konumda 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ırın

Webhook, iş ortağı tarafından oluşturulan ve temsilcinizin mesajlara ve etkinliklere nasıl yanıt vermesi gerektiğini belirten bir HTTPS geri çağırma yöntemidir. Webhook'unuzu yapılandırdıktan sonra, mesaj ve etkinlik almaya başlayabilirsiniz.

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

  1. İş İletişimleri Geliştirici Konsolu'nu 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 için "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 numarayı kullanmanız gerekir.

  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ğerini içeren bir 200 OK yanıtı gönderin.

    Örneğin, webhook'unuz aşağıdaki gövde içeriğini içeren bir POST isteği alırsa:

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

    webhook'unuz clientToken değerini onaylamalı ve clientToken doğruysa yanıt gövdesi olarak 1234567890 ile 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. Developer Console'da Doğrula'yı tıklayın. RBM webhook'unuzu doğruladığında iletişim kutusu kapanır.

Gelen iletileri doğrulama

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

Aldığınız iletinin Google tarafından gönderildiğini doğrulamak için aşağıdaki adımları uygulayın:

  1. İletinin X-Goog-Signature üstbilgisini çıkarın. Bu, mesaj gövdesi yükünün karma ve base64 kodlu bir kopyasıdır.
  2. İsteğin message.body öğesinde RBM yükünün Base-64 kodunu çöz.
  3. Webhook'unuzu ayarlarken belirttiğiniz istemci jetonunu, webhook'unuzun istemci jetonunu anahtar olarak kullanarak base 64 kodu çözülmüş mesaj yükünün baytları için bir SHA512 HMAC oluşturun ve sonucu base64 olarak kodlayın.
  4. X-Goog-Signature karmasını, oluşturduğunuz karma ile karşılaştırın.
    • Karma değerleri eşleşiyorsa mesajın Google tarafından gönderildiğini onaylamış olursunuz.

    • Karmalar eşleşmiyorsa bilinen iyi bir mesajla ilgili karma oluşturma işleminizi kontrol edin.

      Karma oluşturma işleminiz düzgün çalışıyorsa ve size hileli bir şekilde 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 ilk aracınızı oluşturabilirsiniz.