Platform integrations
Connect external advertising platforms to automatically capture leads from your marketing campaigns directly into AI Lead Manager.
Before you begin
Permission: Edit (under Lead Settings) -- Required to connect and manage platform integrations.
- Meta (Facebook) requirements: Admin access to a Meta Business Manager account, active lead ad forms on Facebook or Instagram campaigns, and pop-ups enabled in your browser for the authorization flow.
- Google Ads requirements: Admin access to a Google Ads account, lead form extensions configured on your campaigns, and pop-ups enabled in your browser.
Supported platforms
AI Lead Manager supports direct platform integrations with:
- Meta (Facebook) -- Captures leads from Facebook and Instagram lead ad forms.
- Google Ads -- Captures leads from Google Ads lead form extensions.
Steps
Connect a platform integration
- In AI Lead Manager, navigate to Lead Management > Platform Integration.
- Select Connect account, then choose the platform you want to integrate (for example, Meta ads or Google Ads) from the platform picker.
- The platform's authorization page opens in a new window.
- Sign in to your advertising platform account and grant the requested permissions.
- After successful authorization, the system automatically stores your credentials, sets up webhooks, and syncs your advertising accounts and lead forms.
- The integration status changes to Integration is active.
For detailed setup steps, see Connect Meta (Facebook) integration or Connect Google Ads integration.
Integration status indicators
Each integration displays one of the following status indicators:
| Status indicator | Description |
|---|---|
| Integration is active | The connection is healthy and the integration is receiving leads in real time. |
| Integration is pending activation | The integration is connected but the setup has not been completed. |
| Pending authorization: Complete setup to start capturing leads | The initial authorization has not been completed, or the platform revoked access. |
| Refresh in X days to continue syncing leads | The platform access token is approaching expiration. |
| Integration has expired | The platform access token has expired. Re-authorize immediately to resume lead capture. |
| Connection error occurred | An error prevented the integration from operating correctly. Review the integration settings and re-authorize. |
| Integration is inactive | The integration has been manually deactivated. It retains its configuration but does not receive leads. |
Map form fields to lead fields
After connecting, map the platform's lead form fields to AI Lead Manager lead fields so submissions populate the correct data:
- From the integration details page, navigate to Forms.
- Select a platform form that shows Unmapped or Partially Mapped status.
- Map each platform field to the corresponding AI Lead Manager lead field.
- Select Save Mapping.
For detailed mapping steps, see Configure integration field mapping.
Set default lead properties
Configure the default values applied to every lead captured from an integration:
From the integration details page, navigate to Field properties.
Configure the default values:
Property Description Lead stage The initial pipeline stage for captured leads. Source The lead source (auto-set to the platform name by default). Priority type The priority level assigned to captured leads. Lead type The lead type classification. Center The center the lead is assigned to. Assignee The team member assigned to follow up on captured leads. Select Save.
Refresh integration data
If platform forms or accounts have changed, refresh to sync the latest data:
- On the integration detail page, select Refresh connection.
- The system refreshes advertising account information, available lead forms, and form field definitions.
- Review any newly synced forms and update field mappings if needed.
Reauthorize an expired token
When a token expires, the integration stops receiving leads:
- On the integration detail page, select Authorize.
- Complete the platform authorization process again.
Note: The system updates your stored credentials and restores the connection.
Deactivate an integration
To temporarily stop an integration without losing its configuration:
- On the integration detail page, select Inactive.
- The integration stops receiving leads but retains its settings and field mappings.
- Select Active to resume.
Manage lead sources for an integration
Each integration card has a three-dot action menu. To manage the lead sources associated with an integration:
- Navigate to Lead Management > AI Lead Manager > Platform Integration.
- Select the three-dot menu on the integration card.
- Select Manage lead sources to view and configure which lead sources are active for this integration.
Disconnect an integration
To permanently remove an integration and its configuration:
- On the integration detail page (or the three-dot action menu), select Disconnect integration.
- Enter a reason for disconnecting (required for audit purposes).
- Confirm the disconnection.
Delete an integration
- Navigate to Lead Management > AI Lead Manager > Platform Integration.
- Select the three-dot menu on the integration card.
- Select Delete integration and optionally provide a reason for audit purposes.
- Confirm the deletion.
View HyperConnect as a lead source
If your organization uses HyperConnect, leads captured via HyperConnect voice, SMS, or WhatsApp conversations appear automatically in AI Lead Manager. At centers where HyperConnect is active, a Manage sources tab appears within the Platform Integration section, showing HyperConnect as a configured lead capture source.
- Navigate to Lead Management > AI Lead Manager > Platform Integration.
- Select the Manage sources tab (visible only at centers where HyperConnect is active).
- View the HyperConnect source and its sub-channels (Voice, SMS, WhatsApp).
Note: HyperConnect lead capture is configured through the HyperConnect module, not from this page. See HyperConnect for configuration details.