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:
- First name and last name (“Unknown” when the name isn’t known yet)
- Phone number
- Postal code
- Lead source - the platform the lead came from, for example
YELP - Job_Description__c - the customer’s first message, only when Send job title as Job_Description__c is on
- The images, videos, and documents the customer sends, attached as files. Files over 35 MB are skipped.
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.
- When on - The customer’s first message in the conversation is written into the custom field Job_Description__c on the Lead. It is not written into the standard Description field.
- When off - Job_Description__c is not sent.
Create lead in CRM only when contact info is received
Label: Create lead in CRM only when contact info is received. Default: off.
- When on - Salesforce gets the lead only once the lead has shared a phone number or email, and only if CRMs is checked under Trigger integrations: in the source’s Contact Info tab for that kind of contact info.
- When off - Salesforce gets the lead as soon as the lead first reaches out, even before you have their contact info.
Create only new leads
Label: Create only new leads. Default: off.
- When on - If your business had already messaged the lead before NZ Leads first received the conversation, the lead’s contact info is not sent to Salesforce. New messages in a conversation don’t send the lead again either.
- When off - Those leads and messages are sent too.
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.
- Turning it on asks you to confirm with Enable.
- Salesforce then gets a lead only once the AI confirms the lead is interested, and again with each new message after that.
- It applies to every place that uses this Salesforce integration. Sources without an AI conversation (AI Assistant with Short or Long conversation in Conversation Setup) send no leads to Salesforce while it’s on.
- Can’t be turned on together with Create lead in CRM only when contact info is received or Create only new leads.
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
- For one source - untick the source under Where it’s used in the Salesforce window, or switch Salesforce off on that source’s Integrations tab. If the tab shows Business Settings Active, switch on Customize for Location first. Other sources keep sending.
- Everywhere - turn off Enabled on the Salesforce card, or click Delete integration in the Salesforce window. Every source that used it stops sending to Salesforce.
Records already in Salesforce stay there.
Troubleshooting
- “Salesforce connection is invalid” / leads stopped reaching Salesforce - The OAuth token is no longer valid, for example after the access was revoked in Salesforce. Click Disconnect Salesforce and Yes, then close and reopen the window and click Connect with Salesforce.
- “Needs reconnecting” - This Salesforce integration was copied to another account without its sign-in, for example when sources moved there. It sends nothing until you click Connect with Salesforce in its settings and sign in again.
- No records appearing - Confirm Enabled is on and that Salesforce is on for the source. Check your Create lead in CRM only when contact info is received setting. Also confirm the Salesforce user you connected with has permission to create Leads.
- Job description missing - Turn on Send job title as Job_Description__c. The customer’s first message goes into the custom field Job_Description__c, not into Description.
- A warning icon at the top of the card - Salesforce refused a record, and the integration shows Has errors in your integrations list. Click the icon to read the errors from the last 7 days, and Clear Errors once you’ve fixed the cause.
- Duplicates - Each NZ Leads lead gets its own Salesforce Lead unless Salesforce’s duplicate rules reject it (see Matching and deduplication). Turning on Create lead in CRM only when contact info is received means a record is only created once a phone number or email is known.
Questions about the Salesforce integration? Email support@nzleads.com.