Salesforce

The Salesforce integration creates a Salesforce Lead for every lead NZ Leads handles and keeps it updated. The connection uses OAuth - click Connect with Salesforce, authorize on Salesforce, and you’re done. There is no Leads or Contacts choice: NZ Leads always creates Leads. If your team converts the Lead in Salesforce, later updates go to the converted Contact.

ℹ️

You set Salesforce up once and then choose where it’s used: which businesses, sources, and voice agents send leads to it. Add it from a source’s Messaging Settings → Integrations tab, or from Settings → Integrations in the menu, which lists all your integrations.

What gets synced

Every Lead pushed into Salesforce includes:

After your team converts the Lead, new files are attached to the converted Account and Opportunity.

Connecting Salesforce

Add Salesforce

In NZ Leads, open the source → Messaging Settings → Integrations tab. If the tab shows Business Settings Active, switch on Customize for Location first. Then click Add integration → Create new → Salesforce. The Salesforce window opens. If your account already has a Salesforce integration, pick it on the Use existing tab instead.

Click Connect with Salesforce

You’ll be redirected to Salesforce to authorize the connection. Sign in with the Salesforce user that should own the records being created, then approve the permissions.

You’re returned to NZ Leads

You land on a page that says Salesforce connected & active. Click Continue to open the Salesforce integration on the Integrations page. Enabled is already on.

Validate

Click Validate Connection to confirm everything is wired up.

Choose where it’s used

Salesforce added from a source’s Integrations tab is already on for that source, unless the source already uses another Salesforce integration. To use it for other sources, tick them under Where it’s used in the Salesforce window, then click Done.

To add this Salesforce integration to another source later, open that source’s Integrations tab → Add integration → Use existing and pick it. A source sends to one Salesforce integration at a time: turning on another one there replaces the current one after you confirm. Ticking a business under Where it’s used turns Salesforce on for that business’s sources, including future ones. Sources follow their business unless they choose differently on their own Integrations tab.

In Settings → Integrations, Add integration → Salesforce adds the integration to the business selected in the sidebar and opens its window. Tick the places that should use it under Where it’s used.

Options

Enabled

Turns this Salesforce integration on or off everywhere it’s used. It turns on when you sign in. To stop sending one source’s leads only, switch Salesforce off on that source’s Integrations tab instead.

While Enabled is off, the checkboxes below can’t be changed, except the AI one.

Include source name in lead data

Default: off. The source name isn’t written to the Salesforce Lead either way. Lead Source gets the platform the lead came from.

Send job title as Job_Description__c

Label: Send job title as Job_Description__c. Default: off.

Create lead in CRM only when contact info is received

Label: Create lead in CRM only when contact info is received. Default: off.

Create only new leads

Label: Create only new leads. Default: off.

This option looks at the conversation, not at Salesforce: it doesn’t search Salesforce for an existing record.

Notify this integration only after the AI determines the lead is interested

Label: Notify this integration only after the AI determines the lead is interested. Default: off.

Validate Connection

Tests the OAuth token against Salesforce. If the user’s session has been revoked, you’ll see the error and need to reconnect.

Disconnect Salesforce

Removes the OAuth connection after you confirm with Yes. Salesforce gets nothing until you sign in again. The integration stays where it’s used. To sign in again, close the Salesforce window, open it again, and click Connect with Salesforce.

If you want to revoke the access on Salesforce’s side too, do that from your Salesforce user’s connected-apps settings.

Matching and deduplication

NZ Leads remembers the Salesforce Lead it created for each lead and updates that Lead on later events instead of creating another one. If Salesforce rejects a new Lead as a duplicate, NZ Leads updates the existing Lead instead: the one Salesforce names in its answer, or one it finds with the same phone number or email.

Turning Salesforce off

Records already in Salesforce stay there.

Troubleshooting


Questions about the Salesforce integration? Email support@nzleads.com.

Get Started