Ga naar hoofdinhoud

WhatsApp Business Cloud API Koppeling

Elke organisatie in Sidefish kan haar eigen zakelijke WhatsApp-nummer koppelen om dossieruitnodigingen, ondertekeningsverzoeken en WhatsApp-campagnes rechtstreeks vanuit het eigen kantoornummer te versturen.

1. Architectuur: 1 Centrale Sidefish Meta App​

Sidefish maakt gebruik van het officiële Meta Tech Provider / Embedded Signup model:

  • Geen eigen Meta Developer App nodig voor klanten: Klanten verbinden via de centrale Sidefish Meta App met 1 klik hun eigen WhatsApp Business-account (WABA).
  • WhatsApp Coexistence (Smartphone + Sidefish tegelijk): Kantoren die al de WhatsApp Business-app op een smartphone gebruiken, kunnen tijdens het koppelen de QR-code scannen. Daarmee blijven 1-op-1 gesprekken op de telefoon gewoon werken terwijl Sidefish automatisch uitnodigingen uitstuurt via hetzelfde nummer.
  • Eigen afzender & nummer: Alle berichten worden verzonden vanuit het gekoppelde telefoonnummer en de geverifieerde bedrijfsnaam van het kantoor zelf.

2. Koppelen als Kantoor (in 30 seconden)​

  1. Ga in Sidefish naar Mijn Organisatie en open het tabblad Integraties.
  2. Klik bij WhatsApp Business op "Koppel WhatsApp Business met Meta".
  3. Log in het Meta-venster in met het Facebook/Meta Business-account van het kantoor:
    • Kies "Connect an existing WhatsApp Business App" en scan de QR-code met de mobiele WhatsApp Business-app (versie 2.24.17 of nieuwer), óf
    • Registreer/selecteer een zakelijk telefoonnummer via sms- of telefoonverificatie.
  4. Automatische configuratie: Zodra het Meta-venster sluit, haalt Sidefish automatisch het WABA ID, Phone Number ID en toegangstoken op en dient direct de twee standaard UTILITY-sjablonen (sidefish_dossier_uitnodiging en sidefish_ondertekening_uitnodiging) ter goedkeuring in bij Meta.
  5. Verbinding testen: Vul een gsm-nummer in bij Testnummer en klik op Testbericht verzenden om direct een test-WhatsApp te ontvangen.

3. Berichten Uitsturen​

  • Dossier- & Ondertekeningsverzoeken: Schakel in de verzendwizard de optie WhatsApp Uitnodiging in. Bij meervoudige ondertekening (signingParties) ontvangt elke ondertekenaar zijn persoonlijke ondertekenlink op zijn eigen gsm-nummer.
  • WhatsApp-campagnes: Stuur via Nieuwe actie → WhatsApp-campagne in bulk een goedgekeurd sjabloon naar een selectie van klanten.
  • Automatische Taal-fallback: Als een sjabloon enkel in de standaardtaal van het kantoor (bv. nl) is goedgekeurd bij Meta en een klant op een andere taal staat ingesteld, valt Sidefish bij verzending automatisch terug op de standaardtaal van het kantoor.
  • Aflever- & Leesstatussen: In het communicatielogboek van elk dossier wordt real-time bijgehouden of het WhatsApp-bericht is verzonden (sent), afgeleverd (delivered), gelezen (read) of mislukt (failed).

4. Beheerders-checklist: Centrale Sidefish Meta App instellen​

Voor het Sidefish-platformbeheer zijn de volgende éénmalige instellingen in Meta for Developers vereist:

  1. Meta Business App & Tech Provider:
    • Maak in Meta for Developers één centrale app van het type Business aan en voeg de producten WhatsApp en Facebook Login for Business toe.
    • Voltooi de Bedrijfsverificatie in het Meta Business Portfolio en vraag onder App Review → Permissions and Features Advanced Access aan voor whatsapp_business_messaging en whatsapp_business_management.
    • Zet de app in Live-modus.
  2. Facebook Login for Business (Embedded Signup + Coexistence):
    • Maak onder Facebook Login for Business → Configurations een configuratie aan met variatie WhatsApp Embedded Signup.
    • Activeer WhatsApp Business App Onboarding (Coexistence) en selecteer de rechten whatsapp_business_management en whatsapp_business_messaging.
    • Voeg onder Facebook Login for Business → Settings → Allowed Domains for the JavaScript SDK het admin-domein toe.
  3. Centrale Webhook:
    • Stel onder WhatsApp → Configuration → Webhook de Callback URL https://<api-domein>/api/v1/webhooks/whatsapp en het META_WEBHOOK_VERIFY_TOKEN in.
    • Abonneer op de webhook-velden messages en smb_message_echoes.
  4. Backend Environment Variables:
    • Configureer META_APP_ID, META_APP_SECRET, META_EMBEDDED_SIGNUP_CONFIG_ID en META_WEBHOOK_VERIFY_TOKEN in de backend-omgeving.