This article elaborates on the steps needed to configure the Social25 package. We assume that the user that will do this has the following:
Always use a dedicated API user for access to Social25. This is crucial as Salesforce is rolling out 2FA. |
Fill in a Name and press the Tab key on your keyboard, this will auto-fill the API Name
The Name should be something else than Social25, so use Social25 Connected for example |
Fill in the two required fields as follows
Callback URL | |
---|---|
Selected OAuth Scopes | Full access (full) |
After setting up the connected app, please provide the Social25 team with the following information. You can send this via email to support@gen25.com. After getting confirmation that your tenant has been setup in Heroku, you can proceed to the next section
Key | Value | ||
---|---|---|---|
Salesforce Instance | Organisation ID | The 18 digit organisation ID of your Salesforce instance.
| |
Sandbox | Yes / No | ||
My Domain | The My Domain URL of your Salesforce instance, if applicable | ||
Integration User Salesforce Account | Username | The username of the integration user. Make sure this user has a First and Last name | |
Password | The password of the integration user (preferably this password does not expire). Please use this tool to share this and set expiration to a week | ||
Security Token | The integration user's security token. Please use this tool to share this and set expiration to a week | ||
Permissions | You don't have to provide anything here but make sure that the user has:
| ||
Connected App | Consumer Key | In Setup, go to App Manager. Click on the arrow next to the Connected App you created earlier and select View. The Consumer Key is located under API (Enable OAuth Settings) | |
Consumer Secret | In Setup, go to App Manager. Click on the arrow next to the Connected App you created earlier and select View. The Consumer Secret is located under API (Enable OAuth Settings). Please use this tool to share this and set expiration to a week |
If you are using a development or acceptance environment as well make sure to provide the credentials above multiple times for every instance that needs to be connected. ** Since the Social25 API utilises the Salesforce API it's highly recommended to set the disable the password expiration for these accounts |
Please only proceed with this step once the Social25 team has confirmed that a tenant was created with the previously provided information. |
Every Social25 installation needs at least one Social25 Config record with an active configuration. In this section we will discuss all option available in the Social25 Config and what you can do with these settings
OVERALL | ||
---|---|---|
Active Configuration | Every Social25 installation needs at least one active configuration to work properly | |
Configuration Name | This is the name of the Social25 configuration and is only used for easy identification | |
Connected App | Specify the information as defined in the screenshot below:
| |
Social Persona | If your organisation uses the Salesforce Social Persona object -which comes with Salesforce Social Customer Service-, Social25 will use this object to create Social Personas. In order to do relate these Salesforce Social Personas to Heroku Messages, create a lookup on the Social25 Heroku Message object to the Salesforce Social Persona object and specify it in this field. If you do not have the standard Salesforce Social Persona object, Social25 will use its own Social25 Persona object to capture social profiles and will hide this field from the configuration page.
| |
LINK OPTION | Specify which object you want to use the Social25 chat canvas on. When a new message comes in, a record of this type will be created to which the conversation will be associated. Selecting None will only insert Social25__Heroku_Message__c records for each inbound/outbound message, allowing you to build any logic around this as fit. | |
LEAD / CASE / OPPORTUNITY LINKING SETTINGS | Specify settings specific to Leads, Cases or Opportunities. Also set a default value for any required fields.
| |
ACCOUNT SETTINGS | Specify Account and Contact specific settings and required fields |
If you decide to utilise your own trigger logic, make sure to use None in the LINK OPTIONS |
In order for users to use Social25, they will need the correct license and permission sets. Licenses are not required in a sandbox, so skip steps 2-4 when working in a sandbox.
The Heroku Message object is used for all inbound and outbound messages created on the Social25 platform. The only event on this object is the creation of new records. Records are never updated by the Social25 Heroku application. If you're developing custom triggers that trigger if a new message is received make sure to activate your trigger for this object. New incoming messages can be recognised by the Social25__Outbound__c field. A complete ERD of the Social25 package can be found on the Social25 Salesforce Sync page.
The Lightning Component is only available in Salesforce Lightning Experience |
You can set up the Lightning Component as follows:
|