Skip to main content

SIPTrunk

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 SIPTrunk

  • Username: Enter your SIPTrunk API Access Key.

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

    note

    SIPTrunk uses HTTP Basic authentication built from the Access Key (username) and Secret Key (password). Generate these credentials in the SIPTrunk portal — consult the SIPTrunk 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: siptrunkinbound
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].
note

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

Configure the SIPTrunk inbound webhook​

To receive SMS and MMS messages, configure SIPTrunk to deliver inbound messages to your PBX. In the SIPTrunk portal, locate the inbound messaging / webhook settings (consult the SIPTrunk 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/siptrunkinbound
  • Format: JSON (JSON:API)

Vodia expects the inbound payload in JSON:API format, where the message is under data with type set to message, and message text in data.attributes.body. Media is read from the included array and downloaded.

Outbound messages are sent to https://messaging.siptrunk.com/. MMS is sent by setting is_mms and media_urls.

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