Webhook'unuzu ayarlayın

Webhook'unuzu Business Communications Developer Console veya API ile ayarlayıp ayarlamayacağınızı seçin.

Developer Console API

Webhook, temsilcinizin mesajlara ve etkinliklere nasıl yanıt vermesi gerektiğini belirten, iş ortağı tarafından oluşturulmuş bir HTTPS geri çağırmasıdır. Dialogflow gibi önceden oluşturulmuş bir otomatik çözüm kullanmıyorsanız temsilcinizin davranışını tanımlamak için özel bir webhook ayarlamanız gerekir.

İş ortağı ve aracı düzeyinde webhook'lar

Webhook'unuzu iş ortağı düzeyinde veya aracı düzeyinde ayarlayabilirsiniz. İş ortağı düzeyinde webhook'lar, yönettiğiniz her temsilci için geçerlidir. Temsilci düzeyindeki webhook'ların her biri ise tek bir temsilci için geçerlidir.

Farklı davranışlara sahip birden fazla aracı çalıştırıyorsanız temsilci düzeyinde ayarı kullanarak her temsilci için farklı bir webhook ayarlamak isteyebilirsiniz. Öte yandan, temsilcileriniz benzer davranışlara sahipse veya yalnızca bir temsilciniz varsa iş ortağı düzeyinde webhook'u kullanabilirsiniz.

Hem iş ortağı düzeyinde webhook'u hem de aracı düzeyinde bir webhook'unuz varsa temsilci düzeyindeki webhook kendi aracısına göre önceliklidir. İş ortağı düzeyinde webhook ise temsilci düzeyinde webhook'u olmayan aracılar için geçerlidir.

İş ortağı düzeyinde webhook'unuzu ayarlama

İş ortağı düzeyinde webhook'unuzu ayarlamak için aşağıdaki adımları uygulayın:

1. Business Communications Developer Console'u açın ve Business Messages Google hesabınızla oturum açın.
2. Hesap ayarları'nı açın.
3. Doğru iş ortağı hesabının seçildiğinden emin olun.
4. Business Messages webhook URL'si için Yapılandır'ı tıklayın.
5. Webhook uç nokta URL'si için uygulamanızın URL'sini + "/callback/" girin. Örneğin, "https://PROJECT_ID.appspot.com/callback/" şeklinde olabilir.
6. clientToken değerinizi not edin. Aldığınız iletilerin Google'dan geldiğini doğrulamak için gereklidir.

7. Webhook'unuzu belirtilen clientToken parametresiyle bir POST isteğini kabul edecek şekilde yapılandırın ve yanıt gövdesi olarak gizli parametrenin düz metin değerini içeren bir 200 OK yanıtı gönderin. Örneğin, webhook'unuzun aşağıdaki gövde içeriğiyle bir POST isteği aldığını varsayalım:

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

   Bu durumda, 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.

8. Konsolda Doğrula'yı tıklayın. Business Messages webhook'unuzu doğruladığında iletişim kutusu kapanır.

Temsilci düzeyinde bir webhook ayarlama

Temsilcinize gönderilen mesajlar, iş ortağı düzeyinde webhook'unuzda gönderilir. Belirli bir temsilcinin mesajlarının farklı bir webhook'a ulaşmasını istiyorsanız temsilci düzeyinde bir webhook ayarlayabilirsiniz.

1. Business Communications Developer Console'u açın ve Business Messages Google hesabınızla oturum açın.
2. Temsilcinizi tıklayın.
3. Entegrasyonlar'ı tıklayın.
4. Webhook için Yapılandır'ı tıklayın.
5. Webhook uç nokta URL'si için "https://" ile başlayan webhook'unuzun URL'sini girin.
6. clientToken değerinizi not edin. Aldığınız iletilerin Google'dan geldiğini doğrulamak için gereklidir.

7. Webhook'unuzu belirtilen clientToken parametresiyle birlikte bir POST isteğini kabul edecek şekilde yapılandırın ve gizli parametrenin değeriyle 200 OK yanıtı gönderin. Örneğin, webhook'unuzun aşağıdaki gövde içeriğiyle bir POST isteği aldığını varsayalım:

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

   Bu durumda, webhook'unuz clientToken değerini onaylamalı ve clientToken doğruysa gizli URL parametresi 0123456789 olarak ayarlanmış bir 200 OK yanıtı döndürmelidir.

8. Konsolda Doğrula'yı tıklayın. Business Messages webhook'unuzu doğruladığında iletişim kutusu kapanır.