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

RCS for Business iş ortağı olarak kaydolduktan sonra bir iş ortağı hesabınız olur. İş ortağı hesabı ayarlarınıza erişmek için RCS for Business 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 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 için 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 ilgili kişi	Temsilcilerinizle ilgili teknik sorun yaşanması halinde Google'ın iletişime geçeceği kişi. Bu kişilerin 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 temsilcileriniz için geçerli olur. 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

İşletmeler için RCS 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ümanları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 bir 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.

Partner webhook'unuzu yapılandırma

İş ortağı webhook'unuzu nasıl yapılandıracağınızı öğrenmek için Webhook'lar kılavuzuna bakın.

Teslimat hatalarını önlemek için webhook'ları eşzamansız olarak işleme hakkında bilgi edinmek 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. İstekteki message.body öğesinde RBM yükünün Base64 kodunu çözün.
3. Webhook'unuzun istemci jetonunu (webhook'unuzu ayarlarken belirttiğiniz) anahtar olarak kullanarak, base64 ile kodlanmış 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ğerler eşleşirse Google'ın mesajı gönderdiğini onaylamış olursunuz.

   • Karma değerleri 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
    const headerHash = req.header('X-Goog-Signature');
    const userEventString = Buffer.from(requestBody.message.data, 'base64');
    const hmac = crypto.createHmac('sha512', myClientToken);
    const genHash = hmac.update(userEventString).digest('base64');

    if (headerHash === genHash) {
      const userEvent = JSON.parse(userEventString);
      const webhookType = req.header('X-Goog-Webhook-Type');

      // Route based on the header type
      if (webhookType === 'message_callback') {
        handleMessage(userEvent);
      } else if (webhookType === 'agent_callback') {
        handleAgentEvent(userEvent);
      }
    } else {
      console.log('Hash mismatch - ignoring message');
      res.sendStatus(401);
      return;
    }
  }

  res.sendStatus(200);
  

Sonraki adımlar

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