Relatel API (2.1.2)

This API allows a developer to access data from a Relatel account and to extend Relatel with new functionality.

All phone numbers include the country calling code, without 00 or + prefix. E.g. a Danish number would be: 4571999999.

Relatel supplies two types of products, a virtual switchboard and mobile subscriptions.

Different features and parts of the API depends on the user and/or company having the right features.

The switch product is our virtual switchboard. It has three different plans, Switch Starter, Switch Pro and Switch Premium.

Just a normal sim-card based mobile subscription, but with great love on top. All mobile subscriptions have the same API features.

Some features require both Switch and Mobile, thees will be marked.

The Relatel v2 REST API can be accessed via OAuth 2.0 or with a one-off Access Token which you can create here. This helps us track the usage of your application as well as providing the best possible security and safety to our users' data. OAuth 2.0 is a modern standard used by most providers, large and small.

To use the Relatel v2 REST API with oAuth 2.0 you need to first register your application. Given that each application is tied to it's own URL you might want to register one for development and one for production.

Please note that a user may at any time destroy their access tokens. You might want to take this into account when you're building your application.

Every request to a user's data is authenticated by an access token. To get one the user must accept that they want to use your app. They do this on our domain. Start by redirecting your user to the following address:

https://app.relatel.dk/api/v2/authorize?client_id=YOUR_APPLICATIONS_ID&response_type=code&redirect_uri=YOUR_APPLICATIONS_REDIRECT_URI

Users will be prompted to login (if they aren't already) and then asked if they want to grant you access to their account. If they agree, they are taken to your redirect_uri with a request token as a parameter.

http://example.com/callback?code=REQUEST_TOKEN

Your app then makes a POST request like this:

https://app.relatel.dk/api/v2/token?client_id=YOUR_APPLICATIONS_ID&client_secret=YOUR_APPLICATIONS_SECRET&grant_type=authorization_code&redirect_uri=YOUR_APPLICATIONS_REDIRECT_URI&code=REQUEST_TOKEN

The response will be JSON:

{ "access_token": "ACCESS_TOKEN" }

Chat conversations and messages

Inspect recent orders

Handle sim cards in machines. The M2M related operations requires a separate agreement.

Contacts are used to show information on the other party in a call and are shared with the entire company.

Interact with employees, set do not disturb, send message and list all employees.

Employee groups are collections of employees that can be used to dial or transfer to multiple employees at once.

Receptions are called main numbers in the interface.

Smileys are the feedback from people who have contacted a reception.

After the call or chat has ended, the caller will receive an SMS or email asking for feedback on how the conversation went. This feedback is called a smiley.

The Statistics API allows you to get aggregated stats about calls and chats. The data is updated every 1-2 hours, not in real-time like the other APIs.

Voice mail messages for both mobile and main numbers.

Phone call records and call management