Zum Hauptinhalt springen

Flowroute

Navigate to SMS Management

Add an SMS provider​

  • Log into your Vodia Tenant portal.

  • Click Trunks on the left menu then SMS Management

  • Under the Providers tab click the [+ | Add] button

  • Complete the information.

  • Name: Provide a name (for your purposes)

  • Provider: Select Flowroute

  • Username: Enter your Flowroute API Access Key.

  • Password / Application Secret: Enter your Flowroute API Secret Key.

    note

    Flowroute uses HTTP Basic authentication built from the Access Key (username) and Secret Key (password). You can generate these in the Flowroute portal — consult the Flowroute documentation for the exact location.

  • Click [Save].

Add your SMS numbers​

Now you need to add your DIDs into the Numbers tab.

  • Under the section SMS Management (Trunks on the left menu then SMS Management)
  • Click the Numbers tab and click the [+ | Add] button.
  • Provide a name (for your purposes)
  • Enter your phone number in E.164 format (e.g., +12025551234).
  • Policy: If you have any policy in place, choose it. (optional)
  • Provider: Choose the provider name you have created.
  • URL prefix for receiving messages: Enter something you will use for your SMS callback URL. Eg: flowrouteinbound
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].
note

Vodia automatically strips the leading + from numbers when sending to Flowroute, and re-adds it to inbound numbers, so you should always store your numbers in E.164 (+) format in Vodia.

Configure the Flowroute inbound webhook​

To receive SMS and MMS messages, configure Flowroute to deliver inbound messages to your PBX. In the Flowroute portal, locate the inbound webhook / callback settings (consult the Flowroute documentation for the exact location) and set:

  • Webhook URL: Your PBX URL with the prefix you specified above, for example: https://your-pbx-domain.com/flowrouteinbound
  • Format: JSON (JSON:API)

Vodia expects the inbound payload in Flowroute's JSON:API format, where the message is under data with type set to message, and message text in data.attributes.body.

MMS / media​

When an inbound message includes media, Vodia reads the media reference from the included array and downloads the media file. Outbound MMS is sent by setting is_mms and media_urls.

Outbound messages are sent to https://api.flowroute.com/v2.2/messages.

Your Flowroute SMS integration is now configured and ready to use.