Setting up Inbound Messages with Flowroute

Posted on September 22, 2016 by Flowroute

The following describes how messages are transmitted using Flowroute and received at your callback URL. Flowroute transmits messages to your phone number using HTTP to a callback URL you specify. Inbound messages are formatted using the SMS format. To see this article and more check out our developer site.

Before you begin you must have the following:

1. A Flowroute phone number added to the Direct Inward Dialing DIDS > Manage page on the Flowroute portal

2. A web application server with a public IP or URL.

Callback URLs

The callback URL must be a web resource with a public IP address configured to handle JSON, as shown in the example below.

1. Set the callback URL

Set a callback URL in the SMS Call-Back field in the Preferences > API Control section of the Flowroute portal:

2. Receive an inbound message

When an SMS is sent to a Flowroute DIDs, Flowroute will send a POST HTTP request to your callback URL containing the following information:

screen-shot-2016-09-21-at-10-09-07-pm

 

Example of an inbound message request:

screen-shot-2016-09-21-at-10-12-26-pm

 

Message Auto-Concatenation

Auto-concatenation rules apply to any inbound message. See Message Length & Concatenation for more information.

3. Respond to the HTTP request

When you receive an inbound message, you must respond with a 200 OK response. If you do not send a 200 OK, an attempt is made to resend the message a total of four (4) times at 30-second intervals.

Note: Even if you don’t respond to the request, you will still be billed for that message. However, you can still retrieve the message by looking up the MDR date.

screen-shot-2016-09-21-at-10-09-35-pm
Protect your callback URL: You can protect your callback URL by only accepting inbound connections from Flowroute’s API endpoints. The IP addresses are:
– 52.88.246.140
– 52.10.220.50