Skip to main content

Peoplefone

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 Peoplefone

  • Application Secret / Password: Enter your Peoplefone API bearer token. Vodia sends this as a Bearer authorization header.

    note

    Peoplefone authenticates with a bearer token only — no username is required. Generate the token in the Peoplefone customer portal — consult the Peoplefone 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., +41215550123). Numbers are passed to Peoplefone exactly as entered.
  • 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: peoplefoneinbound
  • Source: It could be your extension number.
  • Destination: It could be your extension number.
  • Click [Save].

Configure the Peoplefone inbound webhook​

To receive messages, configure Peoplefone to deliver inbound messages to your PBX. In the Peoplefone portal, locate the inbound SMS / webhook settings (consult the Peoplefone 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/peoplefoneinbound
  • Format: JSON

Vodia expects the inbound payload as JSON with eventType of SmsMessageEvent and status of received, containing from, to, and text fields.

Outbound messages are sent to https://api.peoplefone.com/customer/sms/v1/sms/messages with a validity period of 14400 seconds.

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