Difference between revisions of "How to make first call"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(41 intermediate revisions by 6 users not shown)
Line 1: Line 1:
[[Image:wee_can_do_it.jpg|200px|right]]
This small guide will show how to make your first call after system installation.
This small guide will show how to make first call after system installation.
 
=Create a tariff=
 
''(For more information about tariffs see [[Tariffs]] page.)''
 
 
Tariffs are a set of rates (prices) to different destinations. In order to make a successfully call, Tariff for a Provider and User have to be created and Rates added at least for one prefix.
 
Go to '''SETTINGS''' -> '''Billing''' -> '''Tariffs''' and click [[file:icon add.png]]'''New tariff'''
 
 
[[File:Tariffs new.png]]
 
 
Firstly let's create a Tariff for Provider, as shown in picture above. Enter the name (you will use it to recognise tariff (price list) in various system places). Choose currency in which you will pay for providers/suppliers. Select what type of tariff do you want and click ''Create''.
 
Once Tariff is created, we can add rates/price to the Tariff. For Provider's Tariff have rates/prices from your Providers that is these prices are paid TO Providers when they terminate calls FROM your system to PSTN. This is self-cost for you, e.g. you buy calls using these prices, as it is written next to the blue information icon.
 
==Rates==
To add rates you can  [[Rate_import_from_CSV| import rates from CSV]] or fill them in manually by clicking [[file:icon rates.png]]'''Rates''' -> [[file: icon add.png]]'''New rate'''. The most important fields in Rates are "Prefix" and "Rates". Importing from CSV is the most popular method when there are many rates, but for test purposes adding Rate(s) manually is the easiest and quickest method.
 
Once we have Provider Tariff and some Rates added to that tariff, we can create Tariff for User. Easiest method to do this is to create User Tariff from Provider Tariff, as displayed in picture below. This will automatically create a User Tariff and also add rates from Provider Tariff.
 
[[File:Make retail tariff from provider.png]]
 
Now we have Provider Tariff and User Tariff. Later in tutorial we will show how to to assign Provider Tariff to particular Provider and User Tariff to particular User.
 
<br><br>
 
=Create a provider=
 
(''For more information about providers see [[Providers]] page.'')
 
 
Go to '''SETTINGS''' -> '''Billing''' -> '''Providers''' and click [[file:icon add.png]]'''New provider'''
 
 
[[File:Providers new.png]]
 
 
Select Technology, from a dropdown list assign Tarrif you have created, select the server and click ''Create''.
<br><br>
==Provider configuration==
 
Right after creating a provider you will see this window:
 
 
[[File:Providers config.png]]
<br><br>
Edit setting you need to edit and click ''Edit'' or leave it as it is configured.
 
 
Basically what needs to be done on this page:
 
* Enabled codecs supported by provider under "Codecs" section;
 
* Select "IP Authentication" under "Authentication" section if provider recognizes your calls by IP, or select "Register" and fill "Login/Username" and "Password" fields;
 
* Put providers "IP" and "Hostname" under "Network related" section. Put IP on both these fields if you know only IP.
 
<br><br>
 
=Create a LCR=
 
(''For more information about LCR see [[LCR]] page.'')
 
 
Go to '''SETTINGS''' -> '''Routing''' -> '''LCR''' and click [[file:icon add.png]]'''New LCR'''
 
 
[[File:Lcr new.png]]
 
 
Enter the name. From a dropdown list select the order. If you select order of providers [[Call_Routing_by_price|by price]] the cheapest way to dial a destination will be used. If you select [[Call_Routing_by_priority_(Manual_LCR)|by priority]] the call will be routed by a predetermined order. Routing [[Routing_by_Percent|by percent]] is similar to routing by priority. After you selected click ''Create''.
 
You will see that there are no providers assigned to this created LCR.
 
 
[[File:Lcr provider.png]]
 
Click [[file:provider.png]]'''Providers'''.
 
 
[[File:Lcr provider1.png]]
 
 
Assign created provider from the dropdown list and click ''Add''.
 
 
Please note that ''Save changes'' button is only for failover providers, not for providers in general.
 
=Adding a user=
 
(''For more information about user management see [[Users]] page.'')


<br>
= Login =


After you [[MOR install from InstallCD | installed MOR from InstallCD]] open your web browser and enter in address field
To add a user go to '''SETTINGS''' -> '''Users'''. Click [[file:icon add.png]]'''Add user'''.


<nowiki>http://<SERVER_IP>/billing</nowiki>


Where <SERVER_IP> is your servers' IP address. <small>([[How to find out servers IP address]])</small>
[[File:User new.png]]


Press ENTER and MOR Login screen will open.


Login with:
Assign created LCR and user Tariff. Then click ''Create'' at the bottom of the page.


* Username: admin
=Add a device for user=
* Password: admin


(''For more information about devices see [[Devices]] page.'')


If you see main MOR screen it means that system is ready to work.


To add a device go to '''SETTINGS''' -> '''Users''' and in the users list click the devices icon ([[file:icon device.png]]). In the opened window click [[file:icon add.png]]'''Add new device'''.


<br>
= Provider =


In order to send calls you need to have [[Providers]] which would deliver your calls to telephone network (PSTN).
[[File:Devices new.png]]


To make life easier we preconfigured Kolmisoft as default Provider so you could start making calls at once.


In order to proceed you need to have some credit to make test call. To get such credit for testing, please [http://www.kolmisoft.com/contacts/ contact us] and send us your <SERVER_IP>.
''Description'' - it is recommended to change it so that it will be easier to recognize it anywhere in the system.


We will open you account and you will be able to start making calls at once!
''PIN'' - you can leave it as it is or enter a new one.


''NOTE: MOR is not limited to only one Provider. You can add your own [[Providers]] at will. But for the sake of simplicity we recommend to try Kolmisoft as provider for quick test calls.''
''Type'' - choose SIP type.


Click ''Create''.


<br>
= Softphone =  
= Softphone =  


To make a real call you will need a softphone for quick test.
To make a real call, you will need a softphone for a quick test.


You can use your own which supports SIP or IAX2 protocol.
You can use your own if it supports the SIP protocol.


For the sake of simplicity we will show how to configure [[Softphones | Idefisk 1.37]] which is very small and easy-configurable.
For the sake of simplicity, we will show how to configure Zoiper, which is popular softphone and is availbale for Windows/Linux/Mac as well as mobile platforms (Android, iOS)


First download from [http://www.kolmisoft.com/packets/idefisk137_installer.exe our server] and install it. <small>(It is for Windows OS.)</small>
First, download it from '''[https://www.zoiper.com/en/voip-softphone/download/current here]''' and install it.  


<small>For Linux it can be [http://www.zoiper.com/zclinux.php downloaded here] for MacOS [http://www.zoiper.com/downloads/free/mac/communicator/ZoiperCommunicatorFree-1.04_installer.dmg here].</small>
Use [[Zoiper configuration | this manual to configure Zoiper]] with your <SERVER_IP> and username/password of User's device in MOR.
 
Use [[Idefisk configuration | this manual to configure Idefisk]] with your <SERVER_IP> and username/password as 101/101.


Also, you can use any other softphone which support SIP protocol. [[Softphones and Mobile dialers | Here ]] is the list of common Softphones.


<br>
<br>
Line 56: Line 141:
= Dialing =
= Dialing =


After that enter some phone number into softphone and try to dial.
Next, enter a phone number into your softphone and try to dial.
 
NOTE: enter number in international (E164 format). E.g. do not use any international prefixes, use country code + area code + number.


As example Lithuanian number is: 37063042439, where 370 - country code, 6 - area code (MOB network), all the rest - number.
NOTE: enter the number in international (E.164) format. Do not use any international prefixes - use country code + area code + number.


NOTE: USA/Canada numbers should start with 1 (it is USA/Canada country code).
For example, a Lithuanian number is 37063042439, where 370 is the country code, 6 is the area code (MOB network), and all the rest is the number itself.


NOTE: USA/Canada numbers should start with 1 (which is the USA/Canada country code).




* If you hear nothing - that means your softphone is not registered to the server.
* If you hear nothing, your softphone is not registered to the server.


* If you hear message from Kolmisoft - that means you do not have account on our server ([http://www.kolmisoft.com/contacts/ contact us] to get it).
* If you hear a message from Kolmisoft, you do not have an account on our server ([http://www.kolmisoft.com/contacts/ contact us] to get one).


* If you hear ringing - that means everything is ok.
* If you hear ringing, everything is okay.




Line 77: Line 161:
= Call Logs =  
= Call Logs =  


After the call you can check your call in the system.
After the call, you can check your call in the system.


Go to: '''STATISTICS - Calls - Last Calls''' and you will see your call.
Go to: '''STATISTICS -> Calls -> Last Calls''' and you will see your call.


It will be already billed.
It will be already billed.
<br><br>

Latest revision as of 06:06, 21 March 2023

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

Create a tariff

(For more information about tariffs see Tariffs page.)


Tariffs are a set of rates (prices) to different destinations. In order to make a successfully call, Tariff for a Provider and User have to be created and Rates added at least for one prefix.

Go to SETTINGS -> Billing -> Tariffs and click Icon add.pngNew tariff


Tariffs new.png


Firstly let's create a Tariff for Provider, as shown in picture above. Enter the name (you will use it to recognise tariff (price list) in various system places). Choose currency in which you will pay for providers/suppliers. Select what type of tariff do you want and click Create.

Once Tariff is created, we can add rates/price to the Tariff. For Provider's Tariff have rates/prices from your Providers that is these prices are paid TO Providers when they terminate calls FROM your system to PSTN. This is self-cost for you, e.g. you buy calls using these prices, as it is written next to the blue information icon.

Rates

To add rates you can import rates from CSV or fill them in manually by clicking Icon rates.pngRates -> Icon add.pngNew rate. The most important fields in Rates are "Prefix" and "Rates". Importing from CSV is the most popular method when there are many rates, but for test purposes adding Rate(s) manually is the easiest and quickest method.

Once we have Provider Tariff and some Rates added to that tariff, we can create Tariff for User. Easiest method to do this is to create User Tariff from Provider Tariff, as displayed in picture below. This will automatically create a User Tariff and also add rates from Provider Tariff.

Make retail tariff from provider.png

Now we have Provider Tariff and User Tariff. Later in tutorial we will show how to to assign Provider Tariff to particular Provider and User Tariff to particular User.



Create a provider

(For more information about providers see Providers page.)


Go to SETTINGS -> Billing -> Providers and click Icon add.pngNew provider


Providers new.png


Select Technology, from a dropdown list assign Tarrif you have created, select the server and click Create.

Provider configuration

Right after creating a provider you will see this window:


Providers config.png

Edit setting you need to edit and click Edit or leave it as it is configured.


Basically what needs to be done on this page:

  • Enabled codecs supported by provider under "Codecs" section;
  • Select "IP Authentication" under "Authentication" section if provider recognizes your calls by IP, or select "Register" and fill "Login/Username" and "Password" fields;
  • Put providers "IP" and "Hostname" under "Network related" section. Put IP on both these fields if you know only IP.



Create a LCR

(For more information about LCR see LCR page.)


Go to SETTINGS -> Routing -> LCR and click Icon add.pngNew LCR


Lcr new.png


Enter the name. From a dropdown list select the order. If you select order of providers by price the cheapest way to dial a destination will be used. If you select by priority the call will be routed by a predetermined order. Routing by percent is similar to routing by priority. After you selected click Create.

You will see that there are no providers assigned to this created LCR.


Lcr provider.png

Click Provider.pngProviders.


Lcr provider1.png


Assign created provider from the dropdown list and click Add.


Please note that Save changes button is only for failover providers, not for providers in general.

Adding a user

(For more information about user management see Users page.)


To add a user go to SETTINGS -> Users. Click Icon add.pngAdd user.


User new.png


Assign created LCR and user Tariff. Then click Create at the bottom of the page.

Add a device for user

(For more information about devices see Devices page.)


To add a device go to SETTINGS -> Users and in the users list click the devices icon (Icon device.png). In the opened window click Icon add.pngAdd new device.


Devices new.png


Description - it is recommended to change it so that it will be easier to recognize it anywhere in the system.

PIN - you can leave it as it is or enter a new one.

Type - choose SIP type.

Click Create.

Softphone

To make a real call, you will need a softphone for a quick test.

You can use your own if it supports the SIP protocol.

For the sake of simplicity, we will show how to configure Zoiper, which is popular softphone and is availbale for Windows/Linux/Mac as well as mobile platforms (Android, iOS)

First, download it from here and install it.

Use this manual to configure Zoiper with your <SERVER_IP> and username/password of User's device in MOR.

Also, you can use any other softphone which support SIP protocol. Here is the list of common Softphones.


Dialing

Next, enter a phone number into your softphone and try to dial.

NOTE: enter the number in international (E.164) format. Do not use any international prefixes - use country code + area code + number.

For example, a Lithuanian number is 37063042439, where 370 is the country code, 6 is the area code (MOB network), and all the rest is the number itself.

NOTE: USA/Canada numbers should start with 1 (which is the USA/Canada country code).


  • If you hear nothing, your softphone is not registered to the server.
  • If you hear a message from Kolmisoft, you do not have an account on our server (contact us to get one).
  • If you hear ringing, everything is okay.



Call Logs

After the call, you can check your call in the system.

Go to: STATISTICS -> Calls -> Last Calls and you will see your call.

It will be already billed.