Anslut en robot på Facebook

  • Artikel

Du kan konfigurera din robot så att den kommunicerar med personer via Facebook Messenger eller Facebook Workplace. Den här artikeln beskriver hur du skapar en Facebook-app med webbplatsen Meta för utvecklare, ansluter din robot till din Facebook-app i Azure och testar din robot på Facebook.

Den här artikeln visar hur du lägger till Facebook-kanalen i din robot via Azure-portalen. Information om hur du använder ett anpassat kanalkort finns i Ytterligare information.

Förutsättningar

  • En Azure-prenumeration. Om du inte redan har ett skapar du ett kostnadsfritt konto innan du börjar.
  • En robot publicerad i Azure som du vill ansluta till Facebook.
  • Ett Facebook för utvecklare-konto. Om du inte har något konto kan du skapa ett på developers.facebook.com.
  • En Facebook-sida där användarna kommer åt din robot. Om du inte har någon ännu skapar du en ny sida.
  • Om du vill använda Facebook Workplace med din robot måste du skapa ett Workplace-konto och en anpassad integrering för att ansluta roboten till.

Skapa Facebook-programmet

Användarna kommer åt din robot från en Facebook-sida. För att ansluta roboten aktiverar du Facebook Messenger på Facebook-sidan och ansluter sedan roboten till sidan.

Skapa ditt program

  1. Logga in på ditt Meta for Developers-konto .
  2. Gå till Skapa en ny Facebook-app.
  3. På sidan Välj en apptyp väljer du Företag och sedan Nästa.
  4. På sidan Ange grundläggande information anger du ett namn för din app och väljer Skapa app.
    • Om du uppmanas till det anger du ditt lösenord och väljer Skicka för att skapa din app.
    • När appen har skapats går webbplatsen till en sida för din app.
  5. Expandera Inställningar och välj Grundläggande.
    1. Kopiera och spara app-ID och apphemlighet.
  6. Under Inställningar väljer du Avancerat.
    1. I den resulterande rutan rullar du ned till säkerhetsinställningarna och aktiverar Tillåt API-åtkomst till appinställningar.
    2. Välj Spara ändringar.

Aktivera Messenger

  1. Välj instrumentpanelen.
  2. I den resulterande rutan rullar du ned till Messenger-panelen och väljer Konfigurera.
  3. Webbplatsen lägger till Messenger-inställningar i din app och visar inställningssidan.

Lägga till sidor och generera token

  1. Under Messenger väljer du Inställningar.

  2. Rulla ned till Åtkomsttoken och välj Lägg till eller ta bort sidor.

    1. När du uppmanas att associera identiteten med Messenger kan du antingen fortsätta med ditt aktuella konto eller logga in på ett annat.
    2. När du uppmanas att ange de sidor som du vill använda med din app väljer du sidorna och väljer sedan Nästa.
    3. Om du uppmanas att skicka begäran om inloggningsgranskning granskar du informationen och väljer Klar.
    4. När det är klart visar webbplatsen en sida med lyckade resultat. Välj OK för att gå vidare.

  3. Sidan som du lade till visas nu i listan Sidor .

    Kopiera och spara sid-ID:t för senare.

  4. Välj Generera token för sidan.

    1. Webbplatsen visar säkerhetsinformation och ger dig möjlighet att kopiera token.
    2. Läs och bekräfta varningen.
    3. Kopiera token och välj Klar.

Nu har du din appinformation och en token för nästa steg. Lämna stegen för Facebook-inställningen väntande. Du uppdaterar dem senare.

Konfigurera din robot i Azure

Aktivera webhooks-integrering för att låta din robot skicka meddelanden och andra händelser till Facebook Messenger.

  1. I ett nytt webbläsarfönster går du till Azure-portalen.
  2. Öppna bladet Azure Bot-resurs för din robot.
  3. Öppna Kanaler och välj Facebook.
  4. I Konfigurera Facebook-kanal anger du den Facebook-information som du kopierade i föregående steg.
    1. Ange ditt Facebook-app-ID och Din Facebook-apphemlighet.
    2. Ange sid-ID och åtkomsttoken.
    3. Kopiera den genererade motringnings-URL :en och verifiera tokenvärden .
    4. Markera Lägga till.

Dricks

  • Om du inte har en kopia av din information från föregående steg kan du hämta den för webbplatsen Meta för utvecklare.
  • Om du behöver det skapar du en ny webbtoken för sidan. Anvisningar finns i Lägga till sidor och generera token.

Aktivera webhooks

Gå tillbaka till Facebook-inställningarna för att slutföra konfigurationsprocessen.

  1. På webbplatsen Meta för utvecklare går du tillbaka till sidan Messenger-inställningar för din app.
  2. I den resulterande rutan rullar du ned till avsnittet Webhooks och väljer Lägg till återanrops-URL.
  3. På sidan Redigera motringnings-URL :
    1. Ange återanrops-URL:en och verifiera tokenvärdena som du kopierade från Azure-portalen.
    2. Välj Verifiera och spara.
  4. Sidan som du lade till visas nu i listan Sidor under Webhooks.
  5. Välj Lägg till prenumerationer för sidan.
    1. På sidan Redigera sidprenumerationer väljer du följande prenumerationsfält :
      • meddelanden
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Välj Spara.
  6. Webbplatsen visar de tillagda prenumerationsfälten bredvid sidan för din robot.

Göra din app offentlig

Tills en app har publicerats är den i utvecklingsläge. Plugin- och API-funktioner fungerar bara för administratörer, utvecklare och testare.

Endast skaparen (Facebook Dev-kontot som skapade sidan och roboten) kan få ett robotsvar. Normala Facebook-användare kan inte se sidan eller roboten. Ge utvecklings- eller testroller till målanvändare, så att de även kan chatta med roboten.

Användare som ska läggas till i testroller måste först registrera sig på webbplatsen Meta för utvecklare. Testarrollen är inte tillgänglig för Facebook-användare som inte har ett Meta for Developers-konto. Mer information om approller och testanvändare finns i dokumentationen om meta för utvecklare.

Skicka till granskning

Facebook kräver en URL för sekretesspolicy och url för tjänstvillkor på sidan för grundläggande appinställningar. Sidan Uppförandekod innehåller resurslänkar från tredje part för att skapa en sekretesspolicy. Sidan Användningsvillkor innehåller exempelvillkor som hjälper dig att skapa ett lämpligt tjänstevillkorsdokument.

När roboten är klar har Facebook en egen granskningsprocess för appar som publiceras i Messenger. Roboten kommer att testas för att säkerställa att den är kompatibel med Facebooks plattformsprinciper.

Göra appen offentlig och publicera sidan

När granskningen har slutförts går du till Appinstrumentpanelen under Appgranskning och ställer in appen på Offentlig. Se till att Facebook-sidan som är associerad med den här roboten har publicerats. Status visas i Sidinställningar.

Ange API-versionen

Om du får ett meddelande från Facebook om utfasning av en viss version av Graph API:

  1. Gå till Meta för utvecklare.
  2. Gå till appen som du skapade för din robot.
  3. Under Inställningar väljer du Avancerat.
  4. Välj Uppgradera API-version och växla sedan Uppgradera alla anrop till version 4.0.

Testa anslutningen genom att följa stegen som beskrivs i avsnittet Testa din robot i Facebook .

Testa din robot på Facebook

Nu kan du testa om din robot är korrekt ansluten till Facebook genom att skicka ett meddelande via den Facebook-sida som du har associerat med din nya Facebook-app.

  1. Gå till Facebook och växla till profilen för din sida.
  2. Välj fler åtgärder (...) och sedan knappen Lägg till åtgärd.
    1. I dialogrutan Anpassa din åtgärd väljer du Prova och följer anvisningarna.
    2. På sidan Åtgärdsknapp under Få personer att kontakta dig väljer du Skicka meddelande.
    3. Välj Nästa, slutför dialogrutan och spara ändringarna.
  3. Växla tillbaka till din personliga profil.
  4. Gå till sidan och välj Meddelande för att testa anslutningen till roboten.

Du kan också testa den här funktionen med hjälp av exempelroboten för Facebook-adaptern genom att fylla i filen appsettings.json med samma värden som beskrivs i föregående steg.

Ytterligare information

Se Exempel på Bot Framework C# Facebook-händelser för en exempelrobot som stöder Facebook Messenger-kommunikation.

Dokumentation om Facebook Messenger finns i:

Dokumentation om Facebook Workplace finns i: