Overview
This API reference provides an overview on how to provision the Fusion platform. Please read the provisioning guide to understand the datamodel that is implemented as well as the generic principles that apply. This API reference intends to provide a comprehensive overview of the different endpoints that are exposed.
How to contribute
If you want to extend the API collection, here are some templates you may want to use:
- API Endpoint Description Template: all currently existing API endpoints are described by editing this template
Service overview
Fusion stands for Direct Routing as a Service. The platform enables organizations that use Microsoft Teams as meeting and collaboration platform to migrate their telephony services to Teams without the need to be a expert in voice.
The service allows to:
- enable voice through direct routing for MS Teams through an easy to use web portal
- select new telephone numbers from different geographies, according to your needs
- port in existing numbers
- connect on-prem PBXs and SIP Trunks
- provision numbers either on Teams or your on prem PBX
- move numbers from on prem to cloud or the other way around
Tenants & subscriptions
A tenant represents an organization that has 1 or more subscriptions on the Fusion platform. In many cases, tenants will have 1 subscription that either uses the platform to provide voice for MS Teams, or SIP trunking, or both. In some cases, for example when there is a need to split the invoiceing, an organizations might opt for multiple subscriptions.
All in all, it are subscriptions that really consume the service. When an organization subscribes to the service, it basically will order a combination of following items:
- MS Teams user licenses: per license, it's possible to attach a phone number to 1 MS Teams user with phonesystem license or to a MS Teams rescource account (auto attendant or call queue)
- Trunking channel: the subscription will be allowed to setup as many simultaneous SIP trunking calls (in+out) as the amount of trunking channels available on subscription level
- Number entitlements: a number entitlement is a number license and gives the right to select 1 phone number from the number inventory. Because number pricing depends on country of origin and number type, different entitlements are defined on the platform.
Customers are able to use the platform within the boundaries set by these licenses and entitlements.
Indirect channel partners
As stated before, it are the tenants who really consume the services offered by the Fusion platform. However, the platform is built to commercialized through an indirect channel:
- distributors are "first level" indirect sales partners who resell the Fusion service. A distributor can either sell directly to end customers (referred to as tenants) or through a reseller ("second level" indirect sales partner).
- resellers refer "second level" indirect sales partners. Also a resellers resells the DraaS service. An important difference with a distributors is that a reseller always sells directly to the end customer. On the other hand, each reseller is managed through a distributor.
Prices
Making calls is unfortunately not a free service. Depending on the subscription, a certain amount of (domestic and/or international minutes might be included in the service offering. However, when more calls are made than included, charges will invoiced to the corresponding tenant.
The Price is a table that defines which charges will be invoiced per destination. Prices are different for MS Teams and for SIP Trunking. When an outbound call is made through the platform, a usage record is created. Depending on the called party as well as the service associated to the calling party, a rate will be selected from the corresponding Price. When both calling and called party reside in the same country (e.g. +3225403885 to +3216474942), the call will be considered as a domestic or national call. Else the call is considered as international.
In order to allow resellers and distributors to make money on the voice minutes, the platform allows to set markups on every level as illustrated below. Distributors and resellers can define how much markup they want to take: