Connecting a Somleng Channel
Somleng is an open source telco and communications platform, supported by UNICEF, with an API compatible with Twilio's. Connect a number on a Somleng instance to send and receive SMS, make and answer voice calls, or both.
Before you start
You'll need an account on a Somleng instance, either one you host or one run for you, with a number on it. You'll also need your account's Account SID and Auth Token from the Somleng dashboard. Somleng's documentation explains how to set up an account and numbers.
Adding the channel
Go to Settings > Channels and click New Channel. Somleng is under SMS & Voice, or you can type its name in the search box.
Then fill in the form:
| Field | What to enter |
|---|---|
| Country | The country your number is in |
| Number | Your number without its country code, or your short code |
| Somleng Host | Your Somleng instance's address, e.g. https://api.somleng.org |
| Role | Whether to use the number for messaging, voice or both |
| Account SID and Auth Token | Your Somleng account's SID and auth token |
| Max Concurrent Calls | Optional. The most calls that can be active at once |
Click Add Channel.
Finishing setup
Once the channel is added, its configuration page shows the URLs to set on your number in Somleng, depending on its role: for incoming messages and message status updates if it's used for messaging, and for incoming calls and call status updates if it's used for voice.
You can come back to these URLs at any time from the channel's page.
Considerations
As Somleng's API is compatible with Twilio's, many of Twilio's guides also apply to it.
To learn more about channels in general, see Introduction to Channels.