Google Business Messages'ı 31 Temmuz 2024'te kullanımdan kaldıracağız. Burayı tıklayarak daha fazla bilgi edinebilirsiniz.

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

Business Messages'a kaydolun

Business Messages'a iş ortağı olarak kaydolduğunuzda şunları etkinleştirebilirsiniz: temsilciler oluşturarak kullanıcılar ile markalar arasındaki konuşmaları web sitesi desteği ve marka gibi işletme işlevlerini temsil eden varlıklar yerler.

Bir kullanıcı, Google Arama veya Google Haritalar'da yönettiğiniz bir markayı bulduğunda, arama sonuçlarında bir Sohbet seçeneği gösterilir. Kullanıcı Chat'i tıkladığında markanın temsilcisine mesaj gönderebilir. Temsilci, gönderilen e-postaları almanıza ve kullanıcının iletilerine gönderir.

İş ortağı olarak kaydolun

Business Messages'a iş ortağı olarak kaydolup markalar için temsilciler oluşturarak, ve temsilcinizi destekleyen API'lerden yararlanarak mesajlaşma özelliğini müşteri hizmetleri, satış ve diğer iş uygulamaları için deneyimler sunar.

Business Communications Developer Console'u açın.
Business Messages altında İş ortağı hesabı oluştur'u tıklayın.

İş ortağı bilgileriniz için değerler 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

ziyaret edin.

Şu belgeyi inceleyin ve kabul edin: Business Messages Hizmet Şartları.
Oluştur'u tıklayın.

Artık Business Messages iş ortağı olarak kayıtlısınız ve Business Messages ile Business Communications API'lerine erişebilirsiniz. Business Messages API kullanıcılara mesaj gönderir. Business Communications API ise 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ı

Business Communications Developer Console ana sayfasında İş ortağı hesabı ayarları'nı tıklayın.
Sol gezinme menüsünde Hizmet hesabı.
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 gizli bir konumda depolayın. Şunları Yapmayın: Anahtarınızı herkese açık olarak paylaşın. Business Message ve Business Communication API'lerine erişmek için daha sonra bu anahtara ihtiyacınız olacaktır.

ziyaret edin.

Webook'unuzu ayarlayın

Business Messages ve Business Communications API etkinleştirildiğine göre başlamak için webhook URL'nizi belirtmelisiniz ileti alma hakkında daha fazla bilgi edinin.

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 webhook'unuzun URL'sini girin. "https://".
clientToken değerinizi not edin. İletilerinizin size ait olduğunu gelen trafik kaynağıdır. Google'da oturum açın.
Webhook'unuzu belirtilen ile bir POST isteğini kabul edecek şekilde yapılandırın clientToken parametresini kullanın ve düz metin içeren bir 200 OK yanıtı gönderin secret parametresinin değerini değiştirin.

Örneğin, webhook'unuz aşağıdaki gibi bir POST isteği alırsa: gövde içeriği
```
{
  "clientToken":"SJENCPGJESMGUFPY",
  "secret":"0123456789"
}
```
webhook'unuz clientToken değerini onaylamalı ve clientToken için geçerliyse doğru, yanıt gövdesi olarak 0123456789 değerini içeren bir 200 OK yanıtı döndürün.
Konsolda Verify (Doğrula) seçeneğini tıklayın.

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

Görüntüleyin Örnek: Webhook URL'sini güncelleme ile webhook'unuzu Business Communication API'leriyle nasıl yapılandıracağınızı öğrenin.

İş ortağı bilgilerini alma

Mevcut iş ortağı bilgilerinizi almak için İşletme İş ortağı kimliğinizle Communications API.

Aşağıdaki komutu çalıştırın. PARTNER_ID yerine İş 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.

Değiştir PARTNER_ID yerine İş Ortağı Kimliğinizi(İş Ortağı Kimliği, Business Communications Developer Console'da bulunabilir) ile birlikte, Güncellediğiniz alan adlarını içeren UPDATED_FIELDS.

# 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üncelleme

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

Artık kayıtlı bir iş ortağı olduğunuza ve API'leri etkinleştirdiğinize göre, geliştirirken bu özelliği kullanmaya devam edebilirsiniz. Hızlı bir başlangıç yapmak için bkz. İlk temsilcinizi oluşturun.

Aksi halde, aracı oluşturma markalarınızı görüşmelerde temsil edin ve webhook'unuzu mesajları alma kullanıcılara gösterir.