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.
- Go to the Advanced Authentication page in SocketLabs
- click +Add DKIM Record in the DKIM Records section
- Select "Generate a TXT record" from the DKIM type box
- Enter the customers domain in the "What domain would you like to add?" box and ipro in the selector box
- 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.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article