M4 How to make first call

From Kolmisoft Wiki
Jump to navigationJump to search

This small guide will show how to make your first call after system installation.

Before making configurations, please read the M4 Routing Logic to see the bigger picture.

Warning.pngIMPORTANT! The configuration will allow any CallerID to dial any Destination from the set IP. Adjust settings accordingly to suit your needs.

Create a Tariff

Read more about M4 Tariffs.

Tariffs are a set of Rates (prices) to different destinations.

Go to Billing > Tariffs and here you will see all tariffs grouped by Buy and Sell Tariffs:

  • Buy Tariff is your self-cost. Usually, you get the Buy Tariff from your Supplier in a CSV format.
  • Sell Tariff is a Tariff for your Users. It’s your Buy Tariff + your profit margin.


A Tariff consists of Rates (prices to a particular prefix).

To make a call, Supplier and User Tariffs must be created and Rates added at least for one prefix.

Go to Billing > Tariffs and click on ADD NEW TARIFF


M4 Add New Tariff.png

  • Choose a name, for example Test_Buy_Tariff
  • Select a currency from a dropdown menu
  • Select Terminator
  • Click on Create.


M4 New Tariff.png

After clicking on Create you'll see a message TARIFF SUCCESSFULLY CREATED.

M4 Tariff successfully created.png

Repeat the same process to create a Sell Tariff for your Clients.

Add Rates

Read more about M4 Rates.

You've just created a Tariff with 0 Rates. The next step is to add Rates. In this simplified guide, we'll add just one rate. Click on RATES (0).

If you want to upload a complete rate sheet, please follow this guide: Import Rates from CSV.



M4 Tariff with 0 Rates.png

Add a rate to your selected prefix/destination that you plan to dial and click on ADD RATE.

In this example, we'll use the prefix 44 that defines United Kingdom - Fixed.



M4 Add Rate.png

Repeat the same process to add rates to your Sell Tariff for your Clients. Just this time add a higher rate than your buying rate to make a profit.

Create Terminator

Read more about M4 Users.

Terminator is your Supplier (Provider). Go to USERS and click Icon add.pngAdd new.

M4 Users Add New.png

  • Create a Username and select "Suggest strong password"
  • Set the Balance range, for example, MIN: 0, MAX 1000. MAX refers to the credit limit that you have with your Supplier. MIN is not relevant here, unless you have a bilateral interconnection agreement with your Supplier and they can be your Client AND Supplier. If you have a bilateral interconnection agreement, then you can set MIN: -1000 which means that you give such a credit limit to them.
  • Scroll down and click Create. You'll see a message "USER SUCCESSFULLY CREATED".



M4 Create Terminator.png

Create Termination Point

Read more about M4 Connection Points.

Click the Connection Point icon and then the ADD NEW CONNECTION POINT button to create a new Connection Point for Terminator.

M4 Create Connection Point.png

Add New Connection Point.png

Fill in the details, choose YES in Act as Termination Point field and click Create.

Act as Termination Point.png

You'll get a confirmation CONNECTION POINT CREATED.

Next, fill in the details (you should get these details from your Supplier's interconnection form).

Enter the proper IP Address and Port in Authentication.

M4 Authentication.png

Set '.*' (without quotes) in Source (CallerID) Allow field. This will allow any CallerID to dial. Read more about M4 Regexp Examples.

Set Source (CallerID) Allow.png

Set the Tariff that you previously created for it. Read more about M4 Tariffs.

Set Tariff.png

Enable the Codecs that you want to use. Scroll down and click Update.

Create Dial Peer

Go to Routing -> Dial Peers -> ADD NEW DIAL PEER.



Add New Dial Peer.png

Set '.*' (without quotes) for Source and Destination regexp. This will allow any CallerID to dial any Destination.

Source and Destination regexp with name.png

Click the List icon, select your Termination Point from the dropdown menu and click ASSIGN.

List Icon.png

Assign termination point.png

Create a Routing Group

Go to Routing -> Routing Groups -> ADD NEW ROUTING GROUP and fill in the details.

Click the DP LIST -> ASSIGN DIAL PEER, select your Dial Peer from the dropdown menu and click ASSIGN.

You'll get a confirmation DIAL PEER SUCCESSFULLY ASSIGNED.

Create Originator

Originator is your Client (Customer). Go to USERS and click Icon add.pngAdd new.

The steps are similar to creating Terminator:

  • Create a Username and select "Suggest strong password"
  • Set the Balance range, for example, MIN: -1000, MAX 0. MAX refers to the credit limit that you give to your postpaid Customer. MAX is not relevant here, unless you have a bilateral interconnection agreement with your Customer and they can be your Customer AND Supplier. If you have a bilateral interconnection agreement, then you can set MAX: 1000 which means that they give such a credit limit.
  • Scroll down and click Create. You'll see a message "USER SUCCESSFULLY CREATED".



Create Origination Point

The steps are similar to creating Termination Point, just this time choose YES in Act as Origination Point field.

Select Automatically create Routing Group for this OP to make the further process faster, unless you prefer creating a Routing Group manually.

You'll see more options in Authentication settings.

You can choose Static IP and add some Tech. Prefix or Dynamic IP if you prefer Username/Password Authentication.

Enable the Codecs that you want to use.

Select the tariff (your Sell Tariff) in the Origination Point Tariff settings.

Scroll down and click Update.

If you chose Automatically create Routing Group for this OP, a Routing Group was created automatically.

Then follow the same process to assign your Dial Peer to Routing Group.



Make a Call

You can make a call from any SIP softphone or other SIP device. Here's an example: M4 Make a call with Ekiga softphone.

Configuration video

Warning.pngIMPORTANT! This video is not up to date.




See Also