Connection Process with OAuth 2.0
- OAuth 2.0 Authentication: The integration uses OAuth 2.0, ensuring secure and reliable connectivity between Orbb and Salesforce.
- Authorization: When connecting, you will be prompted to authorize Orbb to access your Salesforce data.
- Token Exchange: After authorization, OAuth tokens are exchanged, allowing Orbb to interact with your Salesforce data.
OAuth Scopes and Their Purposes
The following scopes are requested by Orbb for Salesforce integration:- id: Grants access to the user’s ID.
- profile: Allows access to the user’s basic profile information.
- email: Permits Orbb to access the user’s email address.
- address: Enables access to the user’s address.
- phone: Grants permission to access the user’s phone number.
- api: Provides general access to the Salesforce API.
- refresh_token: Allows Orbb to obtain a new access token without user intervention.
- offline_access: Ensures continued access to data even when the user is not actively logged in.
- wave_api: Grants access to Salesforce Analytics API.
Connection Options
There are two ways to connect Orbb with Salesforce:-
Admin User Connection:
- Connect using a Salesforce admin user.
- All operations will be executed on behalf of this user.
- Suitable for smaller organizations or testing environments.
-
Bot User Connection:
- Create a dedicated Salesforce user (a ‘bot user’) for integration.
- This user is specially created for interacting with the Orbb app.
- Recommended for larger organizations or where separation of duties is required.
Data Fetching and Field Creation in Salesforce
Orbb fetches data and interacts with Salesforce by following a specific process, which involves the creation of reports in Salesforce and assigning predefined segments in the Orbb app.Creating Reports in Salesforce and Integration with Orbb
-
Salesforce Report Creation:
- Users must create a report within Salesforce and note down its ID.
- The report should be structured according to the data requirements of the Orbb system.
-
Report Integration with Orbb:
- Use the Salesforce report ID to create a corresponding report in the Orbb app.
- Assign one of the predefined segments from Orbb’s list to this report.
Data Synchronization Process
- Automatic Fetching:
- Orbb starts fetching contacts from the Salesforce report into its system.
- The fetch is triggered automatically whenever new contacts meet the criteria of the created report.
Data Processing and Actions
-
Updating Contact Fields:
- Orbb runs the fetched contacts through its system.
- It updates various fields in Salesforce based on the data processed.
-
Lead Creation:
- If a contact meets the predefined Ideal Customer Profile (ICP) criteria, Orbb creates a lead in Salesforce.
- This process helps in identifying potential leads that align with the business’s target customer profile.
Custom Salesforce Fields Created by Orbb
Important NoteOrbb strictly creates only the following specified fields in Salesforce. No other fields are altered or added to ensure the integrity and security of your Salesforce data.Field labels keep the historical
Intail prefix (Orbb’s former brand) so that existing CRM data and reports remain consistent.Custom Fields for Leads
Custom Fields for Contacts
These custom fields enable Orbb to effectively sync and update relevant data in Salesforce, optimizing CRM efficiency and data accuracy.