Important Service Notice
This week we will be operating with modified support hours due to the US Thanksgiving Holiday. SocketLabs team members will not be available for live chat or phone support on Thursday, November 23rd 2017. Normal support hours will resume on Friday November 24th 2017.
Inbound Message Processing and the Inbound API
The Inbound message processing feature allows On-Demand customers to direct their inbound email to SocketLabs servers. The inbound messages are automatically parsed into JSON structures and pushed to a customer HTTP/S endpoint for processing and/or storage. Processing email in this way is particularly useful for mail streams that are to be consumed by business systems such as support ticket managers, issue trackers, and discussion forums. By processing email in this manner, On-Demand customers can now write simple web applications to accept easy-to-manage JSON blobs subject to business logic before injecting them into systems such as those mentioned above.
The Inbound API can be accessed via the 'For Developers' menu. Initially the only control on this page will be a toggle for enabling or disabling the Inbound feature.
Before the settings on this page can be saved, two conditions must be met: the domain(s) to be processed must have their MX records pointing to mx.socketlabs.com; and an Inbound API compatible web application must be running in a location accessible by the On-Demand network. The web application must return the Validation Key from the configuration page in order to pass validation. Once these conditions are met, the URL of the endpoint belongs in the "Endpoint URL" field, and the domain(s) being processed should be added to the configuration.
At this point the Inbound message processing system should post JSON blobs to the configured endpoint for each message it receives. Each JSON blob will contain the Secret Key also found on this configuration page, which endpoints can test for to ensure they don't accept any JSON not coming from the On-Demand network.
Inbound API documentation can be found in our API Reference: http://www.socketlabs.com/api-reference/inbound-api/
A sample endpoint written in C#.NET can be found in our public Git repository: https://github.com/socketlabs/