Megosztás a következőn keresztül:

robot Csatlakozás a Facebookra

  • Cikk

A robotot konfigurálhatja úgy, hogy a Facebook Messengeren vagy a Facebook-munkahelyen 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 adhat hozzá Facebook-csatornát a robothoz az Azure Portalon keresztül. Az egyéni csatornaadapter 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 ilyen fiókkal, a kezdés előtt hozzon létre egy ingyenes fiókot .
  • Az Azure-ban közzétett robot, amelyhez csatlakozni szeretne a Facebookhoz.
  • Facebook for Developers-fiók. Ha nincs fiókja, létrehozhat egyet a developers.facebook.com.
  • Egy Facebook-oldal, amelyről a felhasználók hozzáférhetnek a robothoz. Ha még nem rendelkezik ilyennel, hozzon létre egy új lapot.
  • 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

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 alkalmazás létrehozása

  1. Jelentkezzen be a Meta for Developers-fiókjába .
  2. Nyissa meg az új Facebook-alkalmazás létrehozását.
  3. Az Alkalmazástípus kiválasztása lapon válassza a Vállalkozás, majd a Tovább lehetőséget.
  4. Az Alapszintű információ 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 lapjára kerül.
  5. Bontsa ki a Gépház, és válassza az Alapszintű lehetőséget.
    1. Másolja és mentse az alkalmazásazonosítót és az alkalmazás titkos kódját.
  6. Most a Gépház alatt válassza a Speciális lehetőséget.
    1. Az eredményként kapott panelen görgessen le a Biztonsági beállításokhoz, és engedélyezze az API Access engedélyezése az alkalmazásbeállításokat.
    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éjé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 lapot.

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

  1. A Messenger alatt válassza a Gépház.

  2. Görgessen le a jogkivonatok eléréséhez, é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 az aktuális fiókjával, vagy jelentkezzen be egy másikba.
    2. Amikor a rendszer kéri az alkalmazással használni kívánt oldalakat, jelölje ki a lapokat, majd válassza a Tovább gombot.
    3. Ha a rendszer 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. Sikeresség esetén a webhely egy sikeres lapot jelenít meg. A folytatáshoz kattintson az OK gombra .

  3. A hozzáadott oldal megjelenik a Lapok listában.

    Másolja és mentse az oldalazonosítót későbbre.

  4. Válassza a Laphoz tartozó jogkivonat létrehozása lehetőséget.

    1. A webhely biztonsági információkat jelenít meg, és lehetőséget ad 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. Később frissíteni fogja őket.

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 Facebookot.
  4. A Facebook-csatorna konfigurálása területen adja meg az előző lépésekben másolt Facebook-adatokat.
    1. Adja meg a Facebook-alkalmazás azonosí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 tokenértékeket .
    4. Select Add.

Tipp.

  • Ha nem rendelkezik az előző lépésekből származó adatok másolatával, lekérheti a Meta for Developers webhelyre.
  • Ha szükséges, 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

Térjen 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 kapott panelen görgessen le a Webhookok szakaszhoz, és válassza a Visszahívási URL hozzáadása lehetőséget.
  3. A Visszahívás szerkesztése URL-címen:
    1. Adja meg a visszahívási URL-címet, és ellenőrizze az Azure Portalról másolt tokenértékeket.
    2. Válassza az Ellenőrzés és mentés lehetőséget.
  4. A hozzáadott lap most megjelenik a Lapok listában a Webhookok alatt.
  5. Válassza az Előfizetések hozzáadása a laphoz lehetőséget.
    1. A Lap-előfizetések szerkesztése lapon válassza ki a következő előfizetési mezőket:
      • Üzenetek
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Válassza a Mentés parancsot.
  6. A webhely megjeleníti a robot lapja melletti hozzáadott előfizetési mezőket.

Alkalmazás nyilvánossá tétele

Egy alkalmazás közzétételéig 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.

Csak a létrehozó (az oldalt és a robotot létrehozó Facebook Dev-fiók) kaphat robotválaszt. A normál Facebook-felhasználók nem látják az oldalt vagy a robotot. Fejlesztői vagy tesztelési szerepköröket adhat a célfelhasználóknak, hogy a robottal is cseveghessenek.

A tesztelői szerepkörökhöz hozzáadni kívánt felhasználóknak először regisztrálniuk kell a Meta for Developers webhelyen. A tesztelői szerepkör nem érhető el olyan Facebook-felhasználók számára, akiknek nincs Meta for Developers-fiókja. Az alkalmazásszerepkörökről és a tesztfelhasználókról további információt a Meta for Developers fejlesztői dokumentációjában talál.

Küldés felülvizsgálatra

A Facebooknak szüksége van egy adatvédelmi szabályzat URL-címére és a szolgáltatási feltételek URL-címére az alapvető alkalmazásbeállítások oldalán. A Magatartási Kódex oldal harmadik féltől származó erőforráshivatkozásokat tartalmaz az adatvédelmi szabályzat létrehozásához. A Használati feltételek lap mintafeltételeket tartalmaz a megfelelő szolgáltatási feltételek dokumentumának létrehozásához.

A robot befejezése után a Facebook saját felülvizsgálati folyamattal rendelkezik a Messengerben közzétett alkalmazásokhoz. A robotot teszteljük, hogy megfeleljen a Facebook platformszabályzatainak.

Az alkalmazás nyilvánossá tétele és a lap közzététele

Miután a felülvizsgálat sikeres volt, az Alkalmazás irányítópultján á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 Pages 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 Gépház 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 Facebookban című szakaszban leírt lépéseket követve.

Robot tesztelése a Facebookon

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

  1. Lépjen a Facebookra, és váltson az oldal profiljára.
  2. Válassza ki a további műveleteket (...), majd a Művelet hozzáadása gombot.
    1. A Művelet testreszabása párbeszédpanelen válassza a Kipróbálás lehetőséget, és kövesse az utasításokat.
    2. A Művelet gomb lapJának Címzettek lekérése területén válassza az Üzenet küldése lehetőséget.
    3. Válassza a Tovább gombot, fejezze be a párbeszédpanelt, és mentse a módosításokat.
  3. Váltson vissza a személyes profiljára.
  4. Lépjen a lapra, és válassza az Üzenet lehetőséget a robottal való kapcsolat teszteléséhez.

Ezt a funkciót a Facebook-adapter mintarobotjával is tesztelheti az appsettings.json fájl feltöltésével az előző lépésekben ismertetett értékekkel.

További információk

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

A Facebook Messenger dokumentációját lásd:

A Facebook Workplace dokumentációját lásd: