Robot csatlakoztatása a Facebookhoz

A robotot konfigurálhatja úgy, hogy a Facebook Messengeren vagy a Facebook Workplace-en keresztül kommunikáljon az emberekkel. Ez a cikk bemutatja, hogyan hozhat létre Facebook-alkalmazást a Meta for Developers webhely használatával, hogyan csatlakoztathatja a robotot az Azure-beli Facebook-alkalmazásához, és hogyan tesztelheti a robotot a Facebookon.

Ez a cikk bemutatja, hogyan adhatja hozzá a Facebook-csatornát a robothoz az Azure Portalon keresztül. Az egyéni csatornaadapterek használatáról további információt a További információk című témakörben talál.

Előfeltételek

• Azure-előfizetés. Ha még nem rendelkezik fiókkal, a kezdés előtt hozzon létre egy ingyenes fiókot .
• Az Azure-ban közzétett robot, amelyet a Facebookhoz szeretne csatlakoztatni.
• Egy Facebook for Developers-fiók. Ha nem rendelkezik fiókkal, létrehozhat egyet a developers.facebook.com.
• A Facebook Workplace robottal való használatához létre kell hoznia egy Munkahelyi fiókot és egy egyéni integrációt a robot csatlakoztatásához.

Facebook-alkalmazás létrehozása

Facebook Messenger

A felhasználók egy Facebook-oldalról érhetik el a robotot. A robot csatlakoztatásához engedélyeznie kell a Facebook Messengert a Facebook-oldalon, majd csatlakoztatni kell a robotot az oldalhoz.

Az oldalazonosító lekérése

1. Jelentkezzen be a Meta for Developers-fiókjába .
2. Nyissa meg azt az oldalt, amelyen a felhasználók hozzáférhetnek a robothoz. Ha még nem rendelkezik ilyen laplal, lépjen a Lapok lapra, és válassza az Új lap létrehozása lehetőséget.
3. Nyissa meg az oldal Névjegy lapját, majd másolja és mentse az oldalazonosítót.

Az alkalmazás létrehozása

1. Nyissa meg az Új Facebook-alkalmazás létrehozása gombra.
2. Az Alkalmazástípus kiválasztása lapon válassza az Üzleti , majd a Tovább lehetőséget.
3. Az Alapvető információk megadása lapon adja meg az alkalmazás nevét, és válassza az Alkalmazás létrehozása lehetőséget.
   • Ha a rendszer kéri, adja meg a jelszavát, és válassza a Küldés lehetőséget az alkalmazás létrehozásához.
   • Az alkalmazás létrehozása után a webhely az alkalmazás egy lapjára kerül.
4. Bontsa ki a Beállítások elemet , és válassza az Alapszintű lehetőséget.
   1. Másolja és mentse az alkalmazásazonosítót és az alkalmazáskulcsot.
5. A Beállítások területen válassza a Speciális lehetőséget.
   1. Az eredményként megjelenő panelen görgessen le a Biztonsági beállításokhoz, és engedélyezze az API-hozzáférés engedélyezése az alkalmazásbeállításokhoz.
   2. Válassza a Módosítások mentése lehetőséget.

A Messenger engedélyezése

1. Válassza az Irányítópult lehetőséget.
2. Az eredményül kapott panelen görgessen le a Messenger csempéhez, és válassza a Beállítás lehetőséget.
3. A webhely hozzáadja a Messenger beállításait az alkalmazáshoz, és megjeleníti a beállítások lapját.

Lapok hozzáadása és jogkivonatok létrehozása

1. Görgessen le a Hozzáférési jogkivonatok szakaszhoz, és válassza a Lapok hozzáadása vagy eltávolítása lehetőséget.
   1. Amikor a rendszer kéri, hogy az identitás társítva legyen a Messengerrel, folytassa a jelenlegi fiókjával, vagy jelentkezzen be egy másikba.
   2. Amikor a rendszer rákérdez az alkalmazással használni kívánt lapokra, jelölje ki a lapokat, majd válassza a Tovább gombot.
   3. Ha a rendszer arra kéri, hogy küldje el a bejelentkezési felülvizsgálatra vonatkozó kérést, tekintse át az információkat, és válassza a Kész lehetőséget.
   4. Siker esetén a webhely sikerlapokat jelenít meg. A folytatáshoz kattintson az OK gombra.
2. A hozzáadott lap ekkor megjelenik a Lapok listában.
3. Válassza a Lap jogkivonatának létrehozása lehetőséget.
   1. A webhely biztonsági információkat jelenít meg, és lehetőséget biztosít a jogkivonat másolására.
   2. Olvassa el és nyugtázza a figyelmeztetést.
   3. Másolja ki a jogkivonatot, és válassza a Kész lehetőséget.

Most már rendelkezik az alkalmazás adataival és egy jogkivonattal a következő lépéshez. Hagyja függőben a Facebook beállítási lépéseit. Ezeket később fogja frissíteni.

Robot konfigurálása az Azure-ban

Ha engedélyezni szeretné, hogy a robot üzeneteket és egyéb eseményeket küldjön a Facebook Messengernek, engedélyezze a webhookok integrációját.

1. Egy új böngészőablakban nyissa meg az Azure Portalt.
2. Nyissa meg a robot Azure Bot-erőforrás paneljét.
3. Nyissa meg a Csatornák elemet , és válassza a Facebook lehetőséget.
4. A Facebook-csatorna konfigurálása területen adja meg az előző lépésekben kimásolt Facebook-adatokat.
   1. Adja meg Facebook-alkalmazásazonosítóját és a Facebook-alkalmazás titkos kódját.
   2. Adja meg az oldalazonosítót és a hozzáférési jogkivonatot.
   3. Másolja ki a létrehozott visszahívási URL-címet , és ellenőrizze a jogkivonat értékeit.
   4. Válassza a Hozzáadás lehetőséget.

Tipp

• Ha nem rendelkezik az előző lépésekből származó adatok másolatával, lekérheti a Meta for Developers webhelyre.
• Szükség esetén hozzon létre egy új webes jogkivonatot a laphoz. Útmutatásért lásd: Oldalak hozzáadása és jogkivonatok létrehozása.

Webhookok engedélyezése

Lépjen vissza a Facebook beállításaihoz a konfigurációs folyamat befejezéséhez.

1. A Meta for Developers webhelyen lépjen vissza az alkalmazás Messenger-beállítások lapjára.
2. Az eredményként megjelenő panelen görgessen le a Webhookok szakaszhoz, és válassza a Visszahívási URL-cím hozzáadása lehetőséget.
3. A Visszahívási URL-cím szerkesztése lapon:
   1. Adja meg a visszahívási URL-címet, és ellenőrizze az Azure Portalról kimásolt jogkivonatértékeket.
   2. Válassza az Ellenőrzés és mentés lehetőséget.
4. A hozzáadott lap ekkor megjelenik a Webhookok alatti Lapok listában.
5. Válassza az Add subscriptions for the Page ( Előfizetések hozzáadása a laphoz) lehetőséget.
   1. A Lap előfizetéseinek szerkesztése lapon válassza ki a következő előfizetési mezőket:
      • Üzenetek
      • messaging_postbacks
      • messaging_options
      • message_deliveries
   2. Kattintson a Mentés gombra.
6. A webhely megjeleníti a robot lapja melletti hozzáadott előfizetési mezőket.

Facebook Workplace

Megjegyzés

2019. december 16-án a Workplace by Facebook módosította az egyéni integrációk biztonsági modelljét. A Microsoft Bot Framework v4 használatával létrehozott korábbi integrációkat frissíteni kell a Bot Framework Facebook-adaptereinek használatához az alábbi utasítások szerint 2020. február 28-a előtt.

A Facebook csak azokat az integrációkat veszi figyelembe, amelyek korlátozott hozzáféréssel rendelkeznek a munkahelyi adatokhoz (alacsony bizalmassági engedélyek), és 2020. december 31-ig jogosultak a további használatra, ha az ilyen integrációk befejeződtek és átjutottak a Security RFI-n, és ha a fejlesztő 2020. január 15. előtt eléri a közvetlen támogatáson keresztül az alkalmazás további használatát.

A Facebookhoz egyéni csatornaadapterek érhetők el JavaScript/Node.js és C#/.NET nyelven.

A Facebook Workplace a Facebook üzleti jellegű változata, amely lehetővé teszi az alkalmazottak számára a könnyű kapcsolódást és az együttműködést.

Az alábbi utasítások bemutatják, hogyan hozhat létre egyéni Facebook Workplace-integrációt. Emellett módosítania kell a robotot, hogy egyéni csatornaadaptert használjon a Facebook Workplace-hez.

Prémium szintű munkahelyi fiók létrehozása

Ha még nem rendelkezik fiókkal, hozzon létre egyet.

1. Küldjön be egy alkalmazást a Munkahelyre a vállalata nevében.
2. Miután jóváhagyták az alkalmazást, e-mailben meghívjuk a csatlakozásra. A válasz eltarthat egy ideig.
3. Az e-mail meghívóban válassza az Első lépések lehetőséget.
4. Adja meg a profiladatait.

   Tipp

   Állítsa be magát rendszergazdaként. Ne feledje, hogy csak a rendszergazdák hozhatnak létre egyéni integrációkat.

5. Válassza az Előnézeti profil lehetőséget , és ellenőrizze, hogy helyesek-e az információk.
6. Hozzáférés az ingyenes próbaverzióhoz.
7. Hozzon létre egy jelszót.
8. Válassza a Munkatársak meghívása lehetőséget az alkalmazottak bejelentkezésre való meghívásához. A meghívott alkalmazottak azonnal tagok lesznek, amint aláírják őket. Hasonló bejelentkezési folyamaton mennek keresztül az alábbi lépésekben leírtak szerint.

Egyéni integráció létrehozása

Hozzon létre egy egyéni integrációt a munkahelyéhez. Ha elkészült, a webhely létrehoz egy meghatározott engedélyekkel rendelkező alkalmazást, és egy laptípust Bot (csak a Munkahelyi közösségen belül látható).

1. A Felügyeleti panelen nyissa meg az Integrációk lapot.

2. Válassza a Saját egyéni alkalmazás létrehozása lehetőséget.

   

3. Válassza ki az alkalmazás megjelenítendő nevét és profilképét. Ezek az információk meg lesznek osztva a típuslaplal Bot.

4. Állítsa az Api-hozzáférés engedélyezése az alkalmazásbeállításokhoz beállítást "Igen" értékre.

5. Másolja és biztonságosan tárolja az Ön számára megjelenített alkalmazásazonosítót, titkos alkalmazáskulcsot és alkalmazásjogkivonatot.

   

6. Ezzel befejezte az egyéni integráció létrehozását. A típuslap Bot a Munkahelyi közösségben található, az alábbiakban látható módon.

   

A Facebook-adapter hozzáadása a robotprojekthez

1. Módosítsa a robotprojektet úgy, hogy egyéni csatornaadaptert használjon a Facebookhoz. A Facebook egyéni csatornaadaptere – és annak a robothoz való hozzáadásáról szóló információk – a JavaScript/Node.js vagy a C#/.NET számára érhetők el.
2. A robot konfigurációs fájljához adja hozzá a Facebook-alkalmazásazonosítót, a Facebook-alkalmazás titkos kódját és az oldalelérési jogkivonat értékeit, amelyeket korábban a Facebook Workplace-ből másolt. Hagyományos oldalazonosító helyett használja a Névjegy lapon az integrációs nevet követő számokat.

Alkalmazás nyilvánossá tétele

Küldés felülvizsgálatra

A Facebook megköveteli az adatvédelmi szabályzat URL-címét és a szolgáltatási feltételek URL-címét az alapvető alkalmazásbeállítások oldalán. A Magatartási Kódex oldal külső forráshivatkozásokat tartalmaz, amelyek segítenek adatvédelmi szabályzatot létrehozni. A Használati feltételek lap mintafeltételeket tartalmaz, amelyek segítenek létrehozni a megfelelő szolgáltatási feltételek dokumentumát.

A robot befejezése után a Facebook saját felülvizsgálati folyamattal rendelkezik a Messengerben közzétett alkalmazásokhoz. A robot tesztelése során meggyőződik arról, hogy az megfelel a Facebook platformszabályzatainak.

Az alkalmazás nyilvánossá tétele és az oldal közzététele

Tipp

Amíg egy alkalmazás közzé nem kerül, fejlesztési módban van. A beépülő modul és az API funkciói csak rendszergazdák, fejlesztők és tesztelők számára működnek.

Miután a felülvizsgálat sikeres volt, az Alkalmazás irányítópultján, az Alkalmazás áttekintése területen állítsa az alkalmazást nyilvánosra. Győződjön meg arról, hogy a robothoz társított Facebook-oldal közzé van téve. Az állapot megjelenik a Lapok beállításai között.

Az API-verzió beállítása

Ha értesítést kap a Facebooktól a Graph API egy bizonyos verziójának elavulásáról:

1. Nyissa meg a Meta for Developers webhelyet.
2. Nyissa meg a robothoz létrehozott alkalmazást.
3. A Beállítások területen válassza a Speciális lehetőséget.
4. Válassza az API-verzió frissítése lehetőséget, majd váltson az Összes hívás frissítése 4.0-s verzióra.

Tesztelje a kapcsolatot a Robot tesztelése a Facebookon című szakaszban leírt lépésekkel.

Robot tesztelése a Facebookon

Mostantól tesztelheti, hogy robotja megfelelően csatlakozik-e a Facebookhoz, ha üzenetet küld az új Facebook-alkalmazáshoz társított Facebook-oldalon keresztül.

1. Nyissa meg a Facebook-oldalát.
2. Válassza a Hozzáadás gombot.
3. A Művelet szerkesztése gomblapon válassza az Üzenet küldése lehetőséget.
   1. A Gyakori kérdések lapon tekintse át az alapértelmezett kérdést és választ, majd válassza a Mentés lehetőséget.
   2. A webhely lecseréli az előző Szerkesztési művelet gombot egy új Üzenet szerkesztése gombra.
4. Válassza az Üzenet szerkesztése, majd a Teszt gombot.
   1. A webhely a mintakérdést tartalmazó lapot jeleníti meg javasolt műveletként.
   2. Adja meg a robottal való kapcsolatot tesztelni kívánt üzenetet.

Ezt a funkciót a Facebook-adapter mintarobotjával is tesztelheti, ha feltölti az appsettings.json fájlt a fenti lépésekben leírt értékekkel.

További információ

Tekintse meg a Bot Framework C# Facebook-események mintáját a Facebook Messenger-kommunikációt támogató mintarobothoz.

A Facebook Messenger dokumentációja:

• A Messenger platform dokumentációja.
• Indítás előtti irányelvek
• Első lépések
• Telepítési útmutató

A Facebook Workplace dokumentációja:

• Munkahelyi súgóközpont
• Munkahelyfejlesztői dokumentáció

Robot csatlakoztatása a Facebookhoz a Facebook-adapterrel

A Facebook egyéni csatornaadaptere Elérhető JavaScript/Node.js vagy C#/.NET esetén. A README leírja, hogyan adhatja hozzá a robothoz.

• A Facebook Workplace-hez való csatlakozáshoz a robotnak az egyéni csatornaadaptert kell használnia.
• A Facebook Messengerhez való csatlakozáshoz a robot használhatja az Azure-csatornát vagy az egyéni csatornaadaptert.

A Facebook-alkalmazás egyéni csatornaadaptert használó robothoz való konfigurálásának befejezése:

1. Az alkalmazás irányítópultján válassza a Messengert , majd a Beállítások lehetőséget.

2. A Webhookok szakaszban válassza a Visszahívási URL-cím hozzáadása lehetőséget.

3. A Visszahívási URL-cím szövegmezőbe írja be a robot Facebook-végpontját. Például: https://yourboturl.com/api/facebook.

4. A Jogkivonat ellenőrzése szövegmezőbe írja be a korábban létrehozott és a robotalkalmazás appsettings.json fájljában használt ellenőrző jogkivonatot.

5. Győződjön meg arról, hogy a robot fut, majd válassza az Ellenőrzés és mentés lehetőséget a visszahívási URL-cím ellenőrzéséhez.

6. A visszahívási URL-cím ellenőrzése után válassza az Előfizetések hozzáadása lehetőséget, amely most megjelenik. Az előugró ablakban válassza ki az alábbi előfizetéseket, és válassza a Mentés lehetőséget.

   • Üzenetek
   • messaging_postbacks
   • messaging_optins
   • messaging_deliveries