Botu Facebook'a Bağlan

  • Makale

Botunuzu Facebook Messenger veya Facebook Workplace aracılığıyla kişilerle iletişim kuracak şekilde yapılandırabilirsiniz. Bu makalede Geliştiriciler için Meta sitesini kullanarak bir Facebook uygulaması oluşturma, botunuzu Azure'daki Facebook uygulamanıza bağlama ve botunuzu Facebook'ta test etme işlemleri açıklanır.

Bu makalede, Azure portalı aracılığıyla Botunuza Facebook kanalının nasıl ekleneceği gösterilmektedir. Özel kanal bağdaştırıcısı kullanma hakkında bilgi için bkz . Ek bilgiler.

Ön koşullar

  • Azure aboneliği. Henüz bir hesabınız yoksa başlamadan önce ücretsiz bir hesap oluşturun.
  • Azure'da yayımlanan ve Facebook'a bağlanmak istediğiniz bir bot.
  • Geliştiriciler için Facebook hesabı. Hesabınız yoksa developers.facebook.com bir hesap oluşturabilirsiniz.
  • Kullanıcıların botunuza erişeceği bir Facebook sayfası. Henüz bir sayfanız yoksa Yeni sayfa oluştur'u seçin.
  • Facebook Workplace'i botunuzla birlikte kullanmak için bir Workplace hesabı ve botu bağlamak için özel bir tümleştirme oluşturmanız gerekir.

Facebook uygulaması oluşturma

Kullanıcılar botunuza bir Facebook Sayfasından erişecektir. Botu bağlamak için Facebook Sayfasında Facebook Messenger'ı etkinleştirecek ve ardından botu Sayfaya bağlayacaksınız.

Uygulamanızı oluşturma

  1. Geliştiriciler için Meta hesabınızda oturum açın.
  2. Yeni Facebook Uygulaması oluştur'a gidin.
  3. Uygulama türü seçin sayfasında İş'i ve ardından İleri'yi seçin.
  4. Temel bilgileri sağla sayfasında, uygulamanız için bir ad girin ve Uygulama oluştur'u seçin.
    • İstenirse parolanızı girin ve Gönder'i seçerek uygulamanızı oluşturun.
    • Uygulamanız oluşturulduktan sonra site, uygulamanız için bir sayfaya gider.
  5. Ayarlar genişletin ve Temel'i seçin.
    1. Uygulama Kimliğini ve Uygulama Gizli Dizisini kopyalayıp kaydedin.
  6. Şimdi Ayarlar altında Gelişmiş'i seçin.
    1. Sonuçta elde edilen bölmede, ekranı aşağı kaydırarak Güvenlik ayarları'na gidin ve UYGULAMA ayarlarına API Erişimine İzin Ver'i etkinleştirin.
    2. Değişiklikleri Kaydet'i seçin.

Messenger'ı etkinleştirme

  1. Pano’yu seçin.
  2. Sonuçta elde edilen bölmede, ekranı aşağı kaydırarak Messenger kutucuğuna gelin ve Ayarla'yı seçin.
  3. Site, uygulamanıza Messenger ayarlarını ekler ve ayarlar sayfasını görüntüler.

Sayfa ekleme ve belirteç oluşturma

  1. Messenger'ın altında Ayarlar'ı seçin.

  2. Ekranı aşağı kaydırarak Erişim Belirteçleri'ne gelin ve Sayfa Ekle veya Kaldır'ı seçin.

    1. Kimliğin Messenger ile ilişkilendirilecek olması istendiğinde, geçerli hesabınızla devam edin veya başka bir hesapta oturum açın.
    2. Uygulamanızla kullanmak istediğiniz Sayfalar istendiğinde, sayfaları seçin ve ardından İleri'yi seçin.
    3. Oturum Açma Gözden Geçirme isteğini göndermeniz istenirse bilgileri gözden geçirin ve Bitti'yi seçin.
    4. Başarılı olduğunda, site bir başarı sayfası görüntüler. Devam etmek için Tamam'ı seçin.

  3. Eklediğiniz Sayfa artık Sayfalar listesinde görünür.

    Sonraki sürümler için Sayfa Kimliğini kopyalayıp kaydedin.

  4. Sayfa için belirteç oluştur'a tıklayın.

    1. Site güvenlik bilgilerini görüntüler ve belirteci kopyalama fırsatı verir.
    2. Uyarıyı okuyun ve onaylar.
    3. Belirteci kopyalayın ve Bitti'yi seçin.

Artık uygulama bilgileriniz ve sonraki adım için bir belirteciniz var. Facebook ayarı adımlarını beklemede bırakın. Bunları daha sonra güncelleştireceksiniz.

Azure'da botunuzu yapılandırma

Botunuzun Facebook Messenger'a ileti ve diğer olayları göndermesine izin vermek için web kancaları tümleştirmesini etkinleştirin.

  1. Yeni bir tarayıcı penceresinde Azure portalına gidin.
  2. Botunuzun Azure Bot kaynak dikey penceresini açın.
  3. Kanallar'ı açın ve Facebook'a tıklayın.
  4. Facebook Kanalını Yapılandır bölümünde, önceki adımlarda kopyaladığınız Facebook bilgilerini girin.
    1. Facebook Uygulama Kimliğinizi ve Facebook Uygulama Gizli Dizinizi girin.
    2. Sayfa Kimliğinizi ve Erişim Belirtecinizi girin.
    3. Oluşturulan geri çağırma URL'sini kopyalayın ve belirteç değerlerini doğrulayın.
    4. Ekle'yi seçin.

Bahşiş

  • Önceki adımlarda yer alan bilgilerinizin bir kopyası yoksa, Geliştiriciler için Meta sitesi için alabilirsiniz.
  • Gerekirse sayfa için yeni bir web belirteci oluşturun. Yönergeler için bkz . Sayfa ekleme ve belirteç oluşturma.

Web kancalarını etkinleştirme

Yapılandırma işlemini tamamlamak için Facebook ayarlarına geri dönün.

  1. Geliştiriciler için Meta sitesinde uygulamanızın Messenger ayarları sayfasına geri dönün.
  2. Sonuçta elde edilen bölmede web kancaları bölümüne gidin ve Geri Arama URL'si Ekle'yi seçin.
  3. Geri Arama URL'sini Düzenle sayfasında:
    1. Geri arama URL'sini girin ve Azure portalından kopyaladığınız belirteç değerlerini doğrulayın.
    2. Doğrula ve kaydet'i seçin.
  4. Eklediğiniz Sayfa artık Web Kancaları'nın altındaki Sayfalar listesinde görünür.
  5. Sayfa için Abonelik ekle'yi seçin.
    1. Sayfa aboneliklerini düzenle sayfasında aşağıdaki abonelik alanlarını seçin:
      • iletiler
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Kaydet'i seçin.
  6. Site, eklenen abonelik alanlarını botunuzun Sayfasının yanında görüntüler.

Uygulamanızı genel kullanıma açma

Bir uygulama yayımlanana kadar Geliştirme Modu'nda olur. Eklenti ve API işlevselliği yalnızca yöneticiler, geliştiriciler ve test ediciler için çalışır.

Yalnızca oluşturan (sayfayı ve botu oluşturan Facebook Geliştirici hesabı) bot yanıtı alabilir. Normal Facebook kullanıcıları sayfayı veya botu göremez. Hedef kullanıcılara geliştirme veya test rolleri verin; böylece botla da sohbet edebilir.

Testör rollerine eklenecek kullanıcıların önce Geliştiriciler için Meta sitesine kaydolması gerekir. Test eden rolü, Geliştiriciler için Meta hesabı olmayan Facebook kullanıcıları tarafından kullanılamaz. Uygulama rolleri ve test kullanıcıları hakkında daha fazla bilgi için Geliştiriciler için Meta geliştirici belgelerine bakın.

Gözden geçirme için gönder

Facebook, temel uygulama ayarları sayfasında bir Gizlilik İlkesi URL'si ve Hizmet Koşulları URL'si gerektirir. Kullanım Kuralları sayfası, gizlilik ilkesi oluşturmaya yardımcı olmak için üçüncü taraf kaynak bağlantıları içerir. Kullanım Koşulları sayfası, uygun bir Hizmet Koşulları belgesi oluşturmaya yardımcı olacak örnek terimler içerir.

Bot tamamlandıktan sonra, Facebook'un Messenger'da yayımlanan uygulamalar için kendi inceleme süreci vardır. Bot, Facebook'un Platform İlkeleri ile uyumlu olduğundan emin olmak için test edilecek.

Uygulamayı genel kullanıma açma ve Sayfayı yayımlama

Gözden geçirme başarılı olduktan sonra, Uygulama Panosu'nda Uygulama İncelemesi'nin altında uygulamayı Genel olarak ayarlayın. Bu botla ilişkili Facebook Sayfasının yayımlandığından emin olun. Durum, Sayfalar ayarlarında görünür.

API sürümünü ayarlama

Graph API'sinin belirli bir sürümünün kullanımdan kaldırılması hakkında Facebook'tan bir bildirim alırsanız:

  1. Geliştiriciler için Meta'ya gidin.
  2. Botunuz için oluşturduğunuz uygulamaya gidin.
  3. Ayarlar altında Gelişmiş'i seçin.
  4. API sürümünü yükselt'i seçin, ardından Tüm Çağrıları Yükselt'i sürüm 4.0'a geçirin.

Facebook'ta botunuzu test etme bölümünde açıklanan adımları izleyerek bağlantıyı test edin.

Botunuzu Facebook'ta test edin

Artık yeni Facebook uygulamanızla ilişkilendirdiğiniz Facebook Sayfası aracılığıyla bir mesaj göndererek botunuzun Facebook'a doğru bağlanıp bağlanmadığını test edebilirsiniz.

  1. Facebook'a gidin ve sayfanızın profiline geçin.
  2. Diğer eylemleri (...) ve ardından Eylem Ekle Düğmesi'ni seçin.
    1. Eylem düğmenizi özelleştir iletişim kutusunda Deneyin'i seçin ve yönergeleri izleyin.
    2. Eylem Düğmesi sayfasında, Kişilerin sizinle iletişim kurmasını sağlayın'ın altında İleti Gönder'i seçin.
    3. İleri'yi seçin, iletişim kutusunu tamamlayın ve değişikliklerinizi kaydedin.
  3. Kişisel profilinize geri dönün.
  4. Botunuza bağlantıyı test etmek için sayfanıza gidin ve İleti'yi seçin.

Bu özelliği, appsettings.json dosyasını önceki adımlarda açıklanan değerlerle doldurarak Facebook bağdaştırıcısı için örnek botu kullanarak da test edebilirsiniz.

Ek bilgiler

Facebook Messenger iletişimini destekleyen örnek bir bot için Bkz. Bot Framework C# Facebook olayları örneği .

Facebook Messenger belgeleri için bkz:

Facebook Workplace belgeleri için bkz: