een bot naar Facebook Verbinding maken

  • Artikel

U kunt uw bot configureren om te communiceren met personen via Facebook Messenger of Facebook Workplace. In dit artikel wordt beschreven hoe u een Facebook-app maakt met behulp van de site Meta for Developers, uw bot verbindt met uw Facebook-app in Azure en uw bot test op Facebook.

In dit artikel wordt beschreven hoe u het Facebook-kanaal via Azure Portal aan uw bot toevoegt. Zie Aanvullende informatie voor meer informatie over het gebruik van een aangepaste kanaaladapter.

Vereisten

  • Een Azure-abonnement. Als u nog geen account hebt, maakt u een gratis account voordat u begint.
  • Een bot die naar Azure is gepubliceerd en waarmee u verbinding wilt maken met Facebook.
  • Een Facebook-account voor ontwikkelaars. Als u geen account hebt, kunt u er een maken op developers.facebook.com.
  • Een Facebook-pagina van waaruit gebruikers toegang krijgen tot uw bot. Als u nog geen pagina hebt, maakt u een nieuwe pagina.
  • Als u Facebook Workplace met uw bot wilt gebruiken, moet u een Workplace-account en een aangepaste integratie maken om de bot te verbinden.

Een Facebook-app maken

Gebruikers hebben toegang tot uw bot vanaf een Facebook-pagina. Als u verbinding wilt maken met de bot, schakelt u Facebook Messenger in op de Facebook-pagina en verbindt u de bot vervolgens met de pagina.

Uw app maken

  1. Meld u aan bij uw Meta for Developers-account .
  2. Ga naar Een nieuwe Facebook-app maken.
  3. Selecteer Op de pagina Een app-type selecteren de optie Zakelijk en vervolgens Volgende.
  4. Voer op de pagina Basisinformatie opgeven een naam in voor uw app en selecteer App maken.
    • Als u hierom wordt gevraagd, voert u uw wachtwoord in en selecteert u Verzenden om uw app te maken.
    • Nadat uw app is gemaakt, gaat de site naar een pagina voor uw app.
  5. Vouw Instellingen uit en selecteer Basic.
    1. Kopieer en sla de app-id en het app-geheim op.
  6. Selecteer Nu onder Instellingen Geavanceerd.
    1. Schuif in het resulterende deelvenster omlaag naar de beveiligingsinstellingen en schakel API-toegang tot app-instellingen in.
    2. Selecteer Save Changes.

Messenger inschakelen

  1. Selecteer Dashboard.
  2. Schuif in het resulterende deelvenster omlaag naar de messenger-tegel en selecteer Instellen.
  3. De site voegt Messenger-instellingen toe aan uw app en geeft de instellingenpagina weer.

Pagina's toevoegen en tokens genereren

  1. Selecteer onder Messenger Instellingen.

  2. Schuif omlaag naar Toegangstokens en selecteer Pagina's toevoegen of verwijderen.

    1. Wanneer u wordt gevraagd om de identiteit te koppelen aan Messenger, gaat u verder met uw huidige account of meldt u zich aan bij een andere account.
    2. Wanneer u wordt gevraagd naar de pagina's die u wilt gebruiken met uw app, selecteert u de pagina's en selecteert u vervolgens Volgende.
    3. Als u wordt gevraagd om de aanvraag voor aanmeldingsbeoordeling in te dienen, controleert u de informatie en selecteert u Gereed.
    4. Bij succes wordt op de site een pagina met succes weergegeven. Selecteer OK om door te gaan.

  3. De pagina die u hebt toegevoegd, wordt nu weergegeven in de lijst Pagina's .

    Kopieer en sla de pagina-id op voor later gebruik.

  4. Selecteer Token genereren voor de pagina.

    1. De site geeft beveiligingsgegevens weer en geeft u de mogelijkheid om het token te kopiëren.
    2. Lees en bevestig de waarschuwing.
    3. Kopieer het token en selecteer Gereed.

U hebt nu uw app-gegevens en een token voor de volgende stap. Laat de stappen voor Facebook-instellingen in behandeling. U gaat ze later bijwerken.

Uw bot configureren in Azure

Schakel webhooksintegratie in om uw bot berichten en andere gebeurtenissen naar Facebook Messenger te laten verzenden.

  1. Ga in een nieuw browservenster naar Azure Portal.
  2. Open de azure-botresourceblade voor uw bot.
  3. Open Kanalen en selecteer Facebook.
  4. Voer in Het Facebook-kanaal configureren de Facebook-gegevens in die u in de vorige stappen hebt gekopieerd.
    1. Voer uw Facebook-app-id en Facebook-appgeheim in.
    2. Voer uw pagina-id en toegangstoken in.
    3. Kopieer de gegenereerde callback-URL en verifieer tokenwaarden .
    4. Selecteer Toevoegen.

Fooi

  • Als u geen kopie van uw gegevens uit de vorige stappen hebt, kunt u deze ophalen voor de meta voor ontwikkelaarssite.
  • Als dat nodig is, maakt u een nieuw webtoken voor de pagina. Zie Pagina's toevoegen en tokens genereren voor instructies.

Webhooks inschakelen

Ga terug naar de Facebook-instellingen om het configuratieproces te voltooien.

  1. Ga op de site Meta voor ontwikkelaars terug naar de pagina Messenger-instellingen voor uw app.
  2. Schuif in het resulterende deelvenster omlaag naar de sectie Webhooks en selecteer Callback-URL toevoegen.
  3. Op de pagina Callback-URL bewerken:
    1. Voer de callback-URL in en controleer de tokenwaarden die u hebt gekopieerd uit Azure Portal.
    2. Selecteer Verifiëren en opslaan.
  4. De pagina die u hebt toegevoegd, wordt nu weergegeven in de lijst Pagina's onder Webhooks.
  5. Selecteer Abonnementen toevoegen voor de pagina.
    1. Selecteer op de pagina Paginaabonnementen bewerken de volgende abonnementsvelden:
      • messages
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Selecteer Opslaan.
  6. Op de site worden de toegevoegde abonnementsvelden naast de pagina voor uw bot weergegeven.

Uw app openbaar maken

Totdat een app is gepubliceerd, bevindt deze zich in de ontwikkelingsmodus. De invoegtoepassing en API-functionaliteit werken alleen voor beheerders, ontwikkelaars en testers.

Alleen de maker (het Facebook Dev-account dat de pagina en bot heeft gemaakt) kan een bot-antwoord krijgen. Normale Facebook-gebruikers kunnen de pagina of de bot niet zien. Geef ontwikkel- of testrollen om gebruikers te targeten, zodat ze ook kunnen chatten met bot.

Gebruikers die aan testerrollen moeten worden toegevoegd, moeten zich eerst registreren op de site Meta for Developers. De testerrol is niet beschikbaar voor Facebook-gebruikers die geen Meta voor ontwikkelaars-account hebben. Zie de documentatie voor meta voor ontwikkelaars voor ontwikkelaars voor meer informatie over app-rollen en testgebruikers.

Verzenden voor beoordeling

Facebook vereist een URL van het privacybeleid en de URL van de servicevoorwaarden op de pagina met basis-app-instellingen. De pagina Gedragscode bevat koppelingen naar bronnen van derden om een privacybeleid te maken. De pagina Gebruiksvoorwaarden bevat voorbeeldtermen om een geschikt servicevoorwaardendocument te maken.

Nadat de bot is voltooid, heeft Facebook een eigen beoordelingsproces voor apps die zijn gepubliceerd in Messenger. De bot wordt getest om ervoor te zorgen dat deze voldoet aan het platformbeleid van Facebook.

De app openbaar maken en de pagina publiceren

Nadat de beoordeling is geslaagd, stelt u in het app-dashboard onder App-beoordeling de app in op Openbaar. Zorg ervoor dat de Facebook-pagina die aan deze bot is gekoppeld, is gepubliceerd. De status wordt weergegeven in de pagina-instellingen.

De API-versie instellen

Als u een melding van Facebook ontvangt over het afschaffen van een bepaalde versie van de Graph API:

  1. Ga naar Meta voor ontwikkelaars.
  2. Ga naar de app die u voor uw bot hebt gemaakt.
  3. Selecteer Geavanceerd onder Instellingen.
  4. Selecteer Upgrade-API-versie en schakel vervolgens Alle aanroepen naar versie 4.0 bijwerken over.

Test de verbinding door de stappen te volgen die worden beschreven in de sectie Test your bot in Facebook .

Uw bot testen in Facebook

U kunt nu testen of uw bot correct is verbonden met Facebook door een bericht te verzenden via de Facebook-pagina die u hebt gekoppeld aan uw nieuwe Facebook-app.

  1. Ga naar Facebook en ga naar het profiel voor uw pagina.
  2. Selecteer meer acties (...) en voeg vervolgens de actieknop toe.
    1. Selecteer in het dialoogvenster Uw actieknop aanpassen de optie Uitproberen en volg de instructies.
    2. Selecteer Op de pagina Actieknop onder Personen contact met u laten opnemen, selecteert u Bericht verzenden.
    3. Selecteer Volgende, voltooi het dialoogvenster en sla de wijzigingen op.
  3. Ga terug naar uw persoonlijke profiel.
  4. Ga naar uw pagina en selecteer Bericht om de verbinding met uw bot te testen.

U kunt deze functie ook testen met behulp van de voorbeeldbot voor de Facebook-adapter door het bestand appsettings.json te vullen met dezelfde waarden die in de vorige stappen zijn beschreven.

Aanvullende informatie

Zie het voorbeeld van Bot Framework C# Facebook-events voor een voorbeeldbot die Ondersteuning biedt voor Facebook Messenger-communicatie.

Zie voor Facebook Messenger-documentatie:

Zie de volgende documentatie voor Facebook Workplace: