Your login for our support center is different than your Control Panel login.

Click here to create a login for the support center

 Knowledgebase
Knowledgebase
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.

Configuration

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.

Additional Resources

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/email-on-demand-examples


Comments (0)
Help Desk Software by Kayako  Copyright © 2017 SocketLabs, Inc.  Terms of Service | Privacy Policy | Acceptable Use Policy