Pre-requisites
You must have an active Salesforce account and admin rights to connect to Alguna. We also recommend connecting your Salesforce account in your Sandbox before connecting to production.Overview
Permissions
Alguna automatically sets up technical mechanisms in your Salesforce instance upon connection to enable notifications and benefit from real-time synchronization. For this, we recommend using a user with the System Administrator profile when connecting your Salesforce instance. Otherwise, the user account used needs to have specific permissions.Custom Fields
The Alguna Subscription custom fields as part of Account Object in Salesforce store details about individual subscriptions, including information on the subscription’s status, associated currency, and relevant dates. Below are the fields available within this object, along with their data types and a brief description of each field. Account and Contact Details are supported out of the box:- Account Name
- Account Address
- Account Currency
- Website
- Contact Name
- First Name
- Last Name
- Contact Email
- Title
Alguna Custom Fields
Set up Salesforce
Using the email address of the service account you created earlier, grant the following permissions:Production environment: https://app.alguna.io/settings/integrations
Sandbox environment: https://app.sandbox.alguna.io/settings/integrations
1
First Step
Once logged into the correct environment, go to General Settings → Integrations
2
Second Step
On Integrations Page → Click Connect on Salesforce integration.
A modal will pop-up asking you to allow access into your Salesforce instance.
3
Third Step
Once connected, you may name the integration.
4
Fourth Step
On the next screen, choose to use Alguna as a source of creating new accounts in Salesforce (this setting only applies to Alguna → Salesforce).
5
Fifth Step
On the next screen, choose whether to import existing customers into Alguna. For sandbox testing, you may want to skip importing to keep test data isolated.
Syncing Flow
Account Creation
When an account is created via Alguna, we automatically create an account in Salesforce if you choose to use Alguna as the source of truth for new accounts.- If created via external self-sign up - the process will match automatically.
- If created via Alguna dashboard (new account) - you will need to add additional information via Account → Profile Page (billing information, contact details).
- Any changes in the Account should be reflected in Salesforce within minutes.
Subscription Creation (Requires custom fields setup)
- Subscriptions and any changes to them are automatically synced with Salesforce if the account is connected, regardless of whether the subscription is created via Dashboard or via external self-serve onboarding.
- As soon as there are any changes to the subscription (e.g. new one created / subscription canceled), they should be reflected in Salesforce within minutes.