Bu sayfa, Cloud Translation API ile çevrilmiştir.

Business Messages'a kaydolun

Business Messages'a iş ortağı olarak kaydolduğunuzda, aracılar (web sitesi desteği ve marka konumları gibi işletme işlevlerini temsil eden konuşma varlıkları) oluşturarak kullanıcılar ve markalar arasındaki görüşmeleri etkinleştirebilirsiniz.

Bir kullanıcı Google Arama veya Google Haritalar'da yönettiğiniz bir marka bulduğunda, arama sonuçlarında bir Chat seçeneği görüntülenir. Chat'i tıklayan kullanıcılar markanın temsilcisine mesaj gönderebilir. Temsilci, kullanıcının mesajlarını almanıza ve yanıtlamanıza olanak tanır.

İş ortağı olarak kaydolun

Business Messages'a iş ortağı olarak kaydolarak, markalar için temsilci oluşturarak ve temsilcinizi destekleyen API'lerden yararlanarak müşteri hizmetleri, satışlar ve diğer iş uygulamaları için mesajlaşma deneyimlerini etkinleştirebilirsiniz.

İş İletişimi Geliştirici Konsolu'nu açın.
İşletme Mesajları bölümünde İş ortağı hesabı oluştur'u tıklayın.

İş ortağı bilgileriniz için değerleri girin:

Alan	Değer
Adınız	Tam adınız
İş ortağının adı	Kuruluşunuzun adı
İş ortağı web sitesi	Kuruluşunuzun web sitesi
Bölge	Business Messages hizmetini barındırmak istediğiniz bölge

Business Messages Hizmet Şartları'nı inceleyip kabul edin.
Oluştur'u tıklayın.

Artık Business Messages iş ortağı olarak kaydolup Business Messages ile Business Communication API'lerine erişebilirsiniz. Business Messages API, kullanıcılara mesaj gösterirken Business Communications API aracıları yönetir.

Hizmet hesabı oluşturma

Business Messages ve Business Communications API'lerine yapılan API çağrılarının kimliğini güvenli bir şekilde doğrulamak için bir hizmet hesabı anahtarı ve oauth2l komut satırı aracı kullanmanız gerekir.

İş İletişimi Geliştirici Konsolu ana sayfasında İş ortağı hesabı ayarları'nı tıklayın.
Sol gezinme menüsünde Hizmet hesabı'nı tıklayın.
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. Daha sonra Business Messages ile Business Communication API'lerine erişmek için bu anahtara ihtiyacınız olacak.

Webook'unuzu ayarlama

Business Messages ve Business Communications API etkinleştirildiğine göre artık mesaj almaya başlamak için webhook URL'nizi belirtmelisiniz.

Business Communications Developer Console'da Hesap ayarları'nı açın.
Doğru iş ortağı hesabının seçildiğinden emin olun.
Business Messages webhook URL'si için Yapılandır'ı tıklayın.
Webhook uç nokta URL'si için "https://" ile başlayan webhook'unuzun URL'sini girin.
clientToken değerinizi not edin. Aldığınız iletilerin Google'dan geldiğini doğrulamak için gereklidir.
Webhook'unuzu belirtilen clientToken parametresiyle bir POST isteğini kabul edecek ve yanıt gövdesi olarak secret parametresinin düz metin değerine sahip bir 200 OK yanıtı gönderecek şekilde yapılandırın.

Örneğin, webhook'unuz aşağıdaki gövde içeriğiyle birlikte bir POST isteği alırsa
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
Webhook'unuz clientToken değerini onaylamalı ve clientToken doğruysa yanıt gövdesi olarak 0123456789 ile bir 200 OK yanıtı döndürmelidir.
Konsolda Doğrula'yı tıklayın.

Business Messages webhook'unuzu doğruladığında iletişim kutusu kapanır.

Örnek: Webhook URL'sini güncelleme sayfasına göz atarak Business Communication API'leriyle webhook'unuzu nasıl yapılandıracağınızı öğrenin.

İş ortağı bilgilerini alma

Mevcut iş ortağı bilgilerinizi almak için İş Ortağı Kimliğinizle Business Communication API'yi sorgulayabilirsiniz.

Aşağıdaki komutu çalıştırın. PARTNER_ID yerine iş ortağı kimliğinizi yazın.


# This code gets the partner.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/get

# Replace the __PARTNER_ID__
# Make sure a service account key file exists at ./service_account_key.json

curl -X GET \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)"get-partner.sh

İş ortağı bilgilerini güncelleyin

İş ortağı bilgilerinizi güncellemek için Business Communications Developer Console'daki Hesap ayarları sayfasını kullanabilir veya aşağıdaki komutları çalıştırabilirsiniz.

PARTNER_ID yerine iş ortağı kimliğinizi(İş Ortağı Kimliği, Business Communications Developer Console'da bulunabilir) UPDATED_FIELDS ile, güncellediğiniz alan adlarıyla değiştirin.


# This code updates the partner entity.
# Read more: https://developers.google.com/business-communications/business-messages/reference/business-communications/rest/v1/partners/patch

# Replace the __PARTNER_ID__, __UPDATED_FIELDS__, __FIELD_NAME__, __FIELD_VALUE__
# Make sure a service account key file exists at ./service_account_key.json

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/__PARTNER_ID__?updateMask=__UPDATED_FIELDS__" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json ./service_account_key.json businesscommunications)" \
-d '{
  "__FIELD_NAME__": "__FIELD_VALUE__"
}'update-partner.sh

Biçimlendirme ve değer seçenekleri için bkz. partners.patch.

Örnek: Görünen adı güncelleyin

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/brands/12345/partners/67890?updateMask=displayName" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
    'displayName': 'XYZ Messaging',
}"

Örnek: Webhook URL'sini güncelleme

curl -X PATCH \
"https://businesscommunications.googleapis.com/v1/partners/12345?updateMask=productCapabilities" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/business-communications" \
-H "$(oauth2l header --json /path/to/service/account/key businesscommunications)" \
-d "{
  'productCapabilities': [
    {
      'product': 'BUSINESS_MESSAGES',
      'businessMessagesCapability': {
        'webhookUrl': 'https://xyz.messaging.com/webhook',
      },
    },
  ],
}"

Sonraki adımlar

Kayıtlı bir iş ortağı olduğunuza ve API'leri etkinleştirdiğinize göre artık Business Messages ile uygulama geliştirmeye başlayabilirsiniz. Hızlı bir başlangıç yapmak için İlk aracınızı oluşturma başlıklı makaleye bakın.

Aksi takdirde, markalarınızı görüşmelerde temsil edecek aracıları nasıl oluşturacağınızı ve webhook'unuzu kullanıcılardan mesaj alacak şekilde nasıl yapılandıracağınızı öğrenin.