Add Client To Socket Labs - Global Account

You can test the connections here:

1. Test local connections using the following url - https://socketlabs.ipro-software.com/?me=iproadmin-1Pr0_adm1n859

2. Test the MX Record using the following tool - https://mxtoolbox.com/

Step 1 Create the following DNS entries

• Create an MX record called inbound.example.com that points to mx.socketlabs.com

• Create a CNAME record called bounces.example.com that points to tracking.socketlabs.com

• Create a CNAME record called email.example.com that points to tracking.socketlabs.com.

• Create or modify the TXT record to contain the SPF record for the domain

• (optional) Create a custom DKIM record for the domain (see final step)
  
  

Step 2 create SocketLabs API connection in back office

Go to domain.co.uk/app then navigate to Tools - API Configuration

Create New API Call Socket Labs

ClientID: This is automatically generated

ClientName: Please enter the name "Email Tracking"

Client Secret Key: This is automatically generated

Authorization: Tick both OAuth and IP

IP Addresses: Please add the IP 172.30.1.15

Enabled: Set this to Yes

Using the settings option set the configuration as in screenshot below:

Note the Client ID 

and enter this in The Listener domain by following the steps below. 

Step 3 log into server IPRO-WEB1 and navigate to PROD/sites-global-socketlabs-parsing/siteConfig

Step 4 Open ListenerDomains.config in Notepad++

Step 5 add new Line

<add name="inbound.domain.com" site="//www.Domain.com/" clientID="xxxx" companyEmail="company@email.com" companyEmailName="Company Name" copyToPersonalEmail="true" />

Update the new line to include

• Inbound address
• Site
• clientID
• CompanyEmail
• companyEmailName 

Step 6 Update Socketlabs account with the client specific details

• Log in to Socketlabs - https://cp.socketlabs.com/login
• Username: ipro-software
• Password: 1pr0_50ftw4r3
• Go to https://cp.socketlabs.com/servers/10643/config/inboundapi

Add the inbound record - inbound.clientdomain.com

e.g.

Ensure that you click UPDATE to have the addition take effect, if necessary re-enter the password.

Step 7 Advanced Authentication

In SocketLabs go to the Advanced Authentication page and add the bounces.example.com entry to the Bounce Domains section and the email.example.com entry to the Engagement Tracking Domains section.  This will ensure that SocketLabs uses customised DNS entries within the customers domain for tracking and bounce links, making the emails appear more legitimate and reducing the chances of being marked as spam.

Step 8 Update the Umbraco CMS with the following details:

Go to Features Configuration > Modules

Is Emailing Parsing - Set to On

Email Parse Listener - enter the url inbound.clientdomain.co.uk

Step 9 Run the following test to ensure configuration is correct

Click here to run the iPro Configuration Test

Step 10 Custom DKIM (optional)

SocketLabs use their own DKIM keys to sign all emails sent through their system.  It's possible to set up custom DKIM keys for a customers domain so that emails appear more genuine to the recipients email system.

1. Go to the Advanced Authentication page in SocketLabs
2. click +Add DKIM Record in the DKIM Records section
3. Select "Generate a TXT record" from the DKIM type box
4. Enter the customers domain in the "What domain would you like to add?" box and ipro in the selector box
5. Create a DNS entry for the customer as per the instructions given.  This will be a TXT record like ipro._domainkey.example.com with the value set as per the instructions from SocketLabs

Step 11 Create an enquiry and send test email, respond to email and confirm the email has been received.