If you chose "lead form" as communication channel, leads can be downloaded and retrieved in different ways.
In order to make API requests, you have to request an app review. Dev mode is allowed for some time/number of requests, but when your integration is in production, you should request an app review and switch the app to Live mode. An app in Dev mode could stop working as expected at any moment.
Just go to your page, you must be admin. Then click on Publishing Tools in the top header bar:
From the Publishing Tools page, click on "Forms Library" under the section "Lead Ads Form", on the left hand side. In the Forms Library table, you will find a form called "Marketplace Autos Lead Gen Form":
by clicking "Download", a dialog will appear, asking if you want to download new leads or leads within a specific time range. After selecting your preference, you will be able to download leads in csv or xls format.
Marketplace Vehicles uses the Marketing APIs.
Retrieving leads with Lead Forms requires
Admin access, although Messenger Chat based leads requires only
Publish Content access. When you request permissions to pages of dealers, include
Manage Page access.
Or you can request this with API if you have many dealers. Similar to this guide but you have to include
MANAGE task in
curl \ -F "page_id=<PAGE_ID>" \ -F "permitted_tasks=['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE', 'MANAGE']" \ -F "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN >" \ "https://graph.facebook.com/v3.2/<BUSINESS_ID>/client_pages"
By default, only
Page Admin can access the leads, while sometimes the dealer may enable the customized access to leads. In this case, please make sure the dealer assign your business manager access to the leads.
The app review process could take up to 1-2 weeks including business verification. Please read this guide and prepare required documents in advance.
To receive webhook events from the Facebook Platform, your code must be hosted on a public HTTP server that meets has the following:
Facebook Platform supports versioning and each version is guaranteed to operate for at least two years. A version will no longer be usable two years after the date that the subsequent version is released. So we highly recommend developers to use the most recent API version.
The examples in this guide are in PHP, but you can write your webhook in whatever server-side language you like best.
Before you begin, make sure your server meets all of the requirements listed above.