Skip to Content

Help centre / CRM guides

Salesforce

Connect Salesforce, choose contacts or leads, and see what Vendita reads and writes.

You need a Vendita owner or admin role and a Salesforce user with API access.

Before you connect

Vendita sees what the connecting Salesforce user can see. Use a user who can read Contacts and Leads and these fields: Mobile, Phone, Email, Email Opt Out, and Do Not Call.

Email Opt Out and Do Not Call are hidden from many users by default. If the connecting user cannot see them, Vendita cannot tell who has opted out, and those records will be imported. The preview and Last import warn you when this is the case. Fix field access in Salesforce before you import.

Connect

  1. Open Integrations and find Salesforce under CRM.
  2. Select Connect. Sign in with the standard Salesforce login and approve the requested access.
  3. Return to Vendita and wait for Connected. The card shows your Salesforce address.

A Salesforce admin may need to approve Vendita the first time someone in your organisation connects. Sandboxes are not supported.

Choose contacts

Select Configure import, then follow Choose your CRM audience. For Salesforce:

  • Record type is Contacts or Leads. One import uses one record type. Changing it resets your list view and conditions.
  • Leads means unconverted leads. A converted lead is imported as its contact.
  • Source is a Salesforce List view for that record type.
  • Conditions can use filterable fields the connecting user can see, including custom fields. Owner offers your active Salesforce users by name.
  • A list view can supply up to 2,000 records. A longer one is imported up to that point and Last import says so. For a larger audience, leave the source as All contacts and use conditions instead.

What Vendita reads

In VenditaFrom Salesforce
First name, last nameFirst Name, Last Name
EmailEmail
PhoneMobile, otherwise Phone

A record with Email Opt Out or Do Not Call ticked is always skipped as Opted out. A field the connecting user cannot see arrives empty.

Numbers are used as Salesforce stores them. International format, such as +61 412 345 678, is the most reliable.

What Vendita writes

Nothing, unless you switch on write-back. With it on, for records imported from Salesforce:

OutcomeIn Salesforce
The agent books an appointmentAn event on the contact or lead, with the recent messages and a link to the conversation
The booking moves or is cancelled in VenditaThe same event is updated or removed
The contact asks for a call backA task, due on the day they asked for. Completing the call-back in Vendita completes it
The agent hands over to a personA task, high priority when it is urgent

Vendita does not set an owner, so events and tasks are created under the Salesforce user who connected. That user needs permission to create events and tasks. Contacts, leads, accounts, and opportunities are never changed.

If something is wrong

  • The connection is rejected: check that the Salesforce user has API access, and ask a Salesforce admin whether the app needs approval.
  • Contacts arrive without phone numbers: the connecting user may not have access to Mobile or Phone. Fix field access, then import again.
  • Last import says the list view stopped at 2,000: the first 2,000 records were brought in. Use conditions instead of the list view for the rest.
  • A warning says opted-out records are not skipped: give the connecting user access to the named fields in Salesforce, then preview again.
  • Needs attention: select Reconnect and sign in to the same Salesforce organisation.

On this page