Skip to main content

Connect Facebook

Where to Find It​

Sidebar → Facebook → Facebook Connect (route /integrations/connect-facebook).

Connect Flow​

  1. Click Connect. Whoxa CRM redirects your browser (full-page redirect, not a popup) to: facebook.com/v24.0/dialog/oauth, requesting scopes pages_show_list, pages_messaging, leads_retrieval, ads_management, pages_read_engagement.
  1. Log in and approve permissions for your Facebook account.
  1. Facebook redirects back to Whoxa CRM's backend, which:
    • exchanges the code for a long-lived user access token
    • fetches the list of Pages you manage and connects the first one returned (see the single-Page limitation on the overview)
    • automatically subscribes that Page to Whoxa CRM's webhook — no manual webhook step needed for Facebook, unlike Instagram
  2. You land back on the Connect page with a success toast, showing your Page ID, Page Name, an Active badge, plus Refresh Status and Disconnect buttons.

Webhook Configuration Panel​

The Connect page still displays a Webhook URL and Verification Token — these are informational (useful if you need to double-check or manually re-register the webhook in Meta's dashboard), since the initial subscription already happens automatically during Connect.

The Verification Token is the value your backend admin set for FACEBOOK_WEBHOOK_VERIFY_TOKEN in the API server's .env file.

Disconnecting​

Click Disconnect. This deactivates the Page connection (is_active: false) without deleting stored data. Reconnecting reactivates it and refreshes the token.