Ga naar inhoud

Meta (Instagram & Messenger) Installatiehandleiding

Het koppelen van je bot aan Facebook Messenger en Instagram Direct Messages vereist het configureren van een app in de Meta Developer Portal.

Dit proces bestaat uit verschillende stappen omdat Meta expliciete toestemming en webhooks vereist om berichten van hun platforms naar je FRENZY.BOT instantie te routeren.

Vereisten

Voordat je begint, zorg ervoor dat je beschikt over: 1. Een Facebook-pagina voor je bedrijf. 2. Een Instagram Professional Account (Business of Creator) gekoppeld aan die Facebook-pagina. 3. Toegang tot je FRENZY.BOT dashboard om je Webhook URL op te halen.

Stap 1: Maak een Meta-app aan

  1. Ga naar de Meta Developer Portal en log in.
  2. Klik op My Apps rechtsboven en klik vervolgens op Create App.
  3. Selecteer Other als app-type en klik op Next.
  4. Selecteer Business en klik op Next.
  5. Voer een App Display Name in (bijv. "Mijn Bedrijfs-bot") en je contact e-mailadres.
  6. Selecteer je Business Account (optioneel maar aanbevolen) en klik op Create App.

Stap 2: Voeg Producten toe aan je App

Vanaf je App Dashboard: 1. Scrol omlaag naar Add products to your app. 2. Zoek Messenger en klik op Set Up. 3. Klik in de linker zijbalk op Messenger → Instagram settings (als je Instagram wilt) of blijf op Messenger → settings (voor Facebook Messenger).

Stap 3: Genereer Access Tokens

Je hebt een Page Access Token nodig om FRENZY.BOT toestemming te geven namens jou berichten te versturen.

  1. Zoek onder Messenger → Settings de sectie Access Tokens.
  2. Klik op Add or Remove Pages en authenticeer met je Facebook-account.
  3. Selecteer de Facebook-pagina('s) die je wilt koppelen en verleen de gevraagde machtigingen.
  4. Zodra de pagina is gekoppeld, klik je op Generate Token ernaast.
  5. Kopieer dit token onmiddellijk en sla het op. Je moet dit later in het FRENZY.BOT dashboard plakken.

Stap 4: Configureer de Webhook

Dit vertelt Meta waar inkomende berichten naartoe gestuurd moeten worden.

  1. Ga in je FRENZY.BOT Dashboard naar Channels → Messenger (of Instagram).
  2. Zoek naar je unieke Webhook URL en Verify Token op die pagina.
  3. Ga terug naar de Meta Developer Portal en scrol omlaag naar de sectie Webhooks (onder Messenger Settings).
  4. Klik op Add Callback URL.
  5. Plak de Webhook URL en Verify Token uit je FRENZY.BOT dashboard.
  6. Klik op Verify and Save.

Stap 5: Abonneren op Events

Je moet Meta vertellen welke gebeurtenissen naar je webhook gestuurd moeten worden.

  1. Klik in de Webhooks-sectie op Manage naast je paginanaam.
  2. Abonneer je op de volgende velden:
  3. messages (Vereist voor tekstberichten)
  4. messaging_postbacks (Vereist voor klikken op knoppen/snelle antwoorden)
  5. messaging_optins (Optioneel, voor "Aan de slag"-knoppen)
  6. Klik op Save.

Stap 6: Vind je ID's

Als je Instagram instelt, heb je specifieke ID's nodig:

  1. Instagram Account ID:
  2. Ga naar Facebook Pagina-instellingen → Gekoppelde accounts → Instagram.
  3. Of gebruik de Graph API Explorer: GET /v18.0/me?fields=instagram_business_account
  4. Recipient IGID:
  5. Dit is het Instagram-scoped ID van de persoon die meldingen moet ontvangen (indien Instagram als integratie wordt gebruikt). Voor de kanaalconfiguratie is dit meestal niet vereist, tenzij gespecificeerd in het dashboard.

Stap 7: Afronden in FRENZY.BOT

  1. Ga terug naar je FRENZY.BOT Dashboard (Channels → Messenger of Instagram).
  2. Plak de Page Access Token die je in Stap 3 hebt gegenereerd.
  3. Plak eventuele vereiste ID's (zoals het Instagram Account ID).
  4. Schakel Enable in om het kanaal te activeren.
  5. Klik op Save Settings.

⚠️ Cruciaal: App Review (Live gaan)

Wanneer je voor het eerst een Meta-app aanmaakt, staat deze in de Development Mode.

In de Development Mode zal je bot alleen reageren op jou en andere ontwikkelaars/testers die in de Meta-portal aan de app zijn toegevoegd (onder App Roles).

Om je bot op het grote publiek te laten reageren, moet je: 1. De Business Verification voltooien in de Meta Developer Portal. 2. Advanced Access aanvragen voor specifieke machtigingen (meestal pages_messaging en instagram_manage_messages). 3. Een screencast indienen die laat zien hoe je bot werkt. 4. Zodra deze is goedgekeurd, zet je de app-schakelaar bovenaan het scherm om van Development naar Live.

Let op: Het beoordelingsproces van Meta kan enkele dagen duren.