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

RCS for Business iş ortağı olarak kaydolduktan sonra iş ortağı hesabınız olur. İş ortağı hesabı ayarlarınıza erişmek için RCS for Business Geliştirici Konsolu'nu açın ve İş ortağı hesabı ayarları'nı tıklayın. Buradan şunları 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ığı 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 bilgiyi 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ı durumunda Google'ın iletişime geçeceği kişi. Çocuğunuzun

  • 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 istiyorsanız yalnızca bu aracı için geçerli olacak bir aracı webhook'u yapılandırabilirsiniz.

Markaları yönetme

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

İş 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

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

Markayı düzenleme

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. İstediğiniz düzenlemeleri 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 tablodaki satırında 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 tablosunun 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ğruluyorsunuz. 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 kimliğini güvenli bir şekilde doğrulamak 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ı'nda 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

İş 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 Mesaj işleme başlıklı makaleyi inceleyin.

Gelen iletileri doğrulama

Webhook'lar herhangi bir gönderenden mesaj alabileceğinden, ileti içeriğini işlemeden önce gelen iletilerin 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, e-posta mesajı yükünün karma oluşturma işlemi uygulanmış, Base64 kodlu bir kopyasıdır.
  2. İstekteki 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 olarak kodlayın.
  4. X-Goog-Signature karma değerini oluşturduğunuz karma değerle karşılaştırın.
    • Karma değerleri 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 mesajda 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.

Önceki
İş ortağı olarak kaydolun
Sonraki
İlk temsilcinizi oluşturun