Připojení robota na Facebook

Článek
10/24/2023

Robota můžete nakonfigurovat tak, aby komunikovali s lidmi přes Facebook Messenger nebo Facebook Workplace. Tento článek popisuje, jak vytvořit facebookovou aplikaci pomocí webu Meta pro vývojáře, připojit robota k facebookové aplikaci v Azure a otestovat robota na Facebooku.

Tento článek ukazuje, jak přidat facebookový kanál do robota prostřednictvím webu Azure Portal. Informace o použití vlastního adaptéru kanálu najdete v tématu Další informace.

Předpoklady

Předplatné Azure. Pokud ho ještě nemáte, vytvořte si před zahájením bezplatný účet .
Robot publikovaný v Azure, ke kterému se chcete připojit k Facebooku.
Účet Facebook pro vývojáře. Pokud účet nemáte, můžete si ho vytvořit v developers.facebook.com.
Facebooková stránka, ze které budou uživatelé přistupovat k robotovi. Pokud ho ještě nemáte, vytvořte novou stránku.
Pokud chcete používat facebookové pracoviště s robotem, musíte vytvořit účet pracoviště a vlastní integraci pro připojení robota.

Uživatelé budou k robotovi přistupovat z facebookové stránky. Pokud chcete robota připojit, povolíte Facebook Messenger na facebookové stránce a pak robota připojíte ke stránce.

Vytvoření aplikace

Přihlaste se ke svému účtu Meta for Developers .
Přejděte na Vytvořit novou facebookovou aplikaci.
Na stránce Vybrat typ aplikace vyberte Business a pak Další.
Na stránce Zadat základní informace zadejte název aplikace a vyberte Vytvořit aplikaci.
- Pokud se zobrazí výzva, zadejte heslo a vyberte Odeslat a vytvořte aplikaci.
- Po vytvoření aplikace přejde web na stránku vaší aplikace.
Rozbalte Nastavení a vyberte Základní.
1. Zkopírujte a uložte ID aplikace a tajný klíč aplikace.
Teď v části Nastavení vyberte Upřesnit.
1. Ve výsledném podokně se posuňte dolů k nastavení zabezpečení a povolte povolit přístup k rozhraní API pro nastavení aplikace.
2. Vyberte volbu Uložit změny.

Povolit messenger

Vyberte Řídicí panel.
Ve výsledném podokně se posuňte dolů na dlaždici Messenger a vyberte Nastavit.
Web přidá nastavení Messengeru do vaší aplikace a zobrazí stránku nastavení.

Přidání stránek a generování tokenů

V části Messenger vyberte Nastavení.
Posuňte se dolů k přístupovým tokenům a vyberte Přidat nebo odebrat stránky.
1. Po zobrazení výzvy k přidružení identity k Messengeru pokračujte s aktuálním účtem nebo se přihlaste k jiné.
2. Po zobrazení výzvy k zadání stránek, které chcete použít s aplikací, vyberte stránky a pak vyberte Další.
3. Pokud se zobrazí výzva k odeslání žádosti o kontrolu přihlášení, zkontrolujte informace a vyberte Hotovo.
4. Při úspěchu se na webu zobrazí stránka úspěchu. Pokračujte výběrem tlačítka OK.
Stránka, kterou jste přidali, se zobrazí v seznamu Stránky .

Zkopírujte a uložte ID stránky pro pozdější použití.
Vyberte Vygenerovat token pro stránku.
1. Web zobrazí bezpečnostní informace a poskytne vám možnost zkopírovat token.
2. Přečtěte si upozornění a potvrďte ho.
3. Zkopírujte token a vyberte Hotovo.

Teď máte informace o aplikaci a token pro další krok. Ponechte kroky nastavení Facebooku čekající na vyřízení. Později je aktualizujete.

Konfigurace robota v Azure

Pokud chcete robotovi umožnit odesílání zpráv a dalších událostí na Facebook Messenger, povolte integraci webhooků.

V novém okně prohlížeče přejděte na web Azure Portal.
Otevřete okno prostředku robota Azure pro vašeho robota.
Otevřete Kanály a vyberte Facebook.
V části Konfigurovat facebookový kanál zadejte informace o Facebooku, které jste zkopírovali v předchozích krocích.
1. Zadejte SVOJE ID facebookové aplikace a tajný klíč aplikace pro Facebook.
2. Zadejte ID stránky a přístupový token.
3. Zkopírujte vygenerovanou adresu URL zpětného volání a ověřte hodnoty tokenů .
4. Vyberte Přidat.

Tip

Pokud nemáte kopii informací z předchozích kroků, můžete ji načíst pro web Meta pro vývojáře.
Pokud potřebujete, vytvořte pro stránku nový webový token. Pokyny najdete v tématu Přidání stránek a generování tokenů.

Povolení webhooků

Vraťte se k nastavení Facebooku a dokončete proces konfigurace.

Na webu Meta pro vývojáře se vraťte na stránku nastavení Messengeru pro vaši aplikaci.
Ve výsledném podokně se posuňte dolů do části Webhooky a vyberte Přidat adresu URL zpětného volání.
Na stránce Upravit adresu URL zpětného volání:
1. Zadejte adresu URL zpětného volání a ověřte hodnoty tokenu, které jste zkopírovali z webu Azure Portal.
2. Vyberte Ověřit a uložit.
Stránka, kterou jste přidali, se teď zobrazí v seznamu Stránky v části Webhooky.
Vyberte Přidat předplatná pro stránku.
1. Na stránce Upravit předplatná stránky vyberte následující pole předplatného:
  - zprávy
  - messaging_postbacks
  - messaging_options
  - message_deliveries
2. Zvolte Uložit.
Web zobrazí pole přidaného předplatného vedle stránky robota.

Nastavení veřejné aplikace

Dokud nebude aplikace publikovaná, je v režimu vývoje. Funkce modulu plug-in a rozhraní API budou fungovat jenom pro správce, vývojáře a testery.

Odpověď robota může získat jenom autor (facebookový vývojový účet, který stránku a robota vytvořil). Normální uživatelé Facebooku nevidí stránku ani robota. Poskytněte cílovým uživatelům vývojové nebo testovací role, aby mohli také chatovat s robotem.

Uživatelé, kteří se mají přidat do rolí testeru, se musí nejprve zaregistrovat na webu Meta pro vývojáře. Role testeru není dostupná uživatelům Facebooku, kteří nemají účet Meta pro vývojáře. Další informace o rolích aplikací a testování uživatelů najdete v dokumentaci pro vývojáře meta pro vývojáře.

Odeslat ke kontrole

Facebook vyžaduje adresu URL zásad ochrany osobních údajů a adresu URL podmínek služby na základní stránce nastavení aplikace. Stránka Pravidla chování obsahuje odkazy na zdroje třetích stran, které vám pomůžou vytvořit zásady ochrany osobních údajů. Stránka Podmínky použití obsahuje ukázkové termíny, které vám pomůžou vytvořit odpovídající dokument podmínek služby.

Po dokončení robota má Facebook svůj vlastní proces kontroly pro aplikace publikované v Messengeru. Robot se otestuje, aby zajistil, že vyhovuje zásadám platformy Facebooku.

Nastavení aplikace jako veřejné a publikování stránky

Po úspěšném dokončení kontroly na řídicím panelu aplikace v části Kontrola aplikace nastavte aplikaci na Veřejné. Ujistěte se, že je publikovaná facebooková stránka přidružená k tomuto robotovi. Stav se zobrazí v nastavení stránky.

Nastavení verze rozhraní API

Pokud obdržíte oznámení z Facebooku o vyřazení určité verze rozhraní Graph API:

Přejděte na Meta pro vývojáře.
Přejděte do aplikace, kterou jste vytvořili pro robota.
V části Nastavení vyberte Upřesnit.
Vyberte Upgrade verze rozhraní API a pak přepněte možnost Upgradovat všechna volání na verzi 4.0.

Otestujte připojení podle kroků popsaných v části Testování robota na Facebooku .

Testování robota na Facebooku

Teď můžete otestovat, jestli je robot připojený k Facebooku správně, odesláním zprávy přes facebookovou stránku, kterou jste přidružli k nové aplikaci Facebook.

Přejděte na Facebook a přepněte na profil stránky.
Vyberte další akce (...) a pak tlačítko Přidat akci.
1. V dialogovém okně Přizpůsobit tlačítko akce vyberte Vyzkoušet a postupujte podle pokynů.
2. Na stránce Tlačítko akce v části Získat lidi, které vás budou kontaktovat, vyberte Odeslat zprávu.
3. Vyberte Další, dokončete dialogové okno a uložte provedené změny.
Přepněte zpět na svůj osobní profil.
Přejděte na stránku a výběrem možnosti Zpráva otestujte připojení k robotovi.

Tuto funkci můžete otestovat také pomocí ukázkového robota pro adaptér Facebooku tak, že naplníte soubor appsettings.json stejnými hodnotami popsanými v předchozích krocích.

Další informace

Ukázku událostí facebookových událostí v C# služby Bot Framework najdete u ukázkového robota, který podporuje komunikaci s Aplikací Facebook Messenger.

Dokumentace ke službě Facebook Messenger najdete tady:

Dokumentace k Facebooku na pracovišti najdete tady:

Sdílet prostřednictvím