Zum Hauptinhalt springen

Bandwidth

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 Bandwidth

  • Username: Enter your credentials in the format accountId/apiUsername/applicationId (three values separated by forward slashes).

    • accountId — your Bandwidth account ID
    • apiUsername — your Bandwidth API user
    • applicationId — the Messaging Application ID that your number is associated with

    For example -

    5000001/jsmith_api/a1b2c3d4-0000-1111-2222-333344445555
    note

    All three values are required and must be in the exact order accountId/apiUsername/applicationId. The same API username is also used to authenticate when downloading inbound MMS media.

  • Application Secret / Password: Enter your Bandwidth API password. This is combined with the API username for HTTP Basic authentication.

  • 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. Bandwidth numbers are passed through as-is, so use the format that matches your Bandwidth configuration (typically E.164, 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: bandwidthinbound
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].

Configure the Bandwidth inbound webhook​

To receive SMS and MMS messages, your Bandwidth Messaging Application must be configured to deliver inbound message callbacks to your PBX. Refer to the Bandwidth dashboard documentation for the exact location of these settings, and configure:

  1. The Inbound Callback URL (also called the Messaging Callback URL) on the Messaging Application associated with your number:
    • Set it to your PBX URL with the prefix you specified above, for example: https://your-pbx-domain.com/bandwidthinbound
  2. Ensure the Application ID you entered in the Vodia username field matches the application your number is assigned to.

Bandwidth delivers inbound events as a JSON array. Vodia handles the message-received event (delivering the SMS/MMS to the extension) and logs message-delivered and message-failed status events.

MMS / media​

For inbound MMS, Vodia downloads the media from the Bandwidth media URL using the same API credentials. Supported media types that are forwarded include JPG, PNG, JPEG, and PDF.

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