Difference between revisions of "Call Tracing"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(17 intermediate revisions by 5 users not shown)
Line 2: Line 2:
= MOR Call Tracing Overview =  
= MOR Call Tracing Overview =  


This function is for checking the setup of MOR in order to be sure a user will be able to dial out. To set MOR up isn't simple, but we are trying to make it easier with this manual and with improvements to GUI. It often happens that users miss some important detail while trying to make everything work. Call Tracing will save a lot of head-scratching, and we hope it will be helpful for beginners.
This function is for checking the setup of MOR in order to be sure a User will be able to dial out. To set MOR up isn't simple, but we are trying to make it easier with this manual and with improvements to GUI. It often happens that Users miss some important detail while trying to make everything work. Call Tracing will save a lot of head-scratching, and we hope it will be helpful for beginners.


This function can be found in '''SETTINGS –> Billing –> Function –> Call Tracing'''. It can be quickly accessed in the Users menu (SETTINGS –> Users) as well. Just click on the [[Image:icon_call_tracing.png]] icon for a User.


<big>'''Important! This function is for testing Dialing OUT. DID testing is not yet implemented.'''</big>
'''NOTE''' that Accountant can use this functionality with Call Tracing Usage permission.
 
 
This function can be found in '''SETTINGS –> Billing –> Function –> Call Tracing'''. It can be quickly accessed in the Users menu (SETTINGS –> Users) as well. Just click on the [[Image:icon_call_tracing.png]] icon for a user.
 
In the first window, we have to select which user we want to check:
 


In the first window, we have to select which User we want to check:
<br><br>
[[Image:calltracing1.png]]
[[Image:calltracing1.png]]
<br><br>


= User testing =  
= User testing =  


The next window shows us whether we have configured everything properly for the selected user. Let's look at each section separately.  
The next window shows us whether we have configured everything properly for the selected User. Let's look at each section separately.  
 
The first section shows information special to the user:


The first section shows information special to the User:
<br><br>
[[Image:calltracing2.png]]
[[Image:calltracing2.png]]
<br><br>


Here we see three errors [[Image:icon_cross.png]] that prevent the User from operating. Let's say we want to allow a User to make Calls. We will go through each of the errors and fix them.




Here we see four errors [[Image:icon_cross.png]] that prevent the user from operating. Let's say we want to allow a user to make calls. We will go through each of the errors and fix them.
1. This error tells us that the User is Blocked and so unable to make Calls. We should go to [[User Details]] and unblock him.
 


1. This error tells us that the user is Blocked and so unable to make calls. We should go to [[User Details]] and unblock him.
2. Balance and Credit for this User are empty, and the User type is Prepaid. That means he has no funds to cover the Call fees. There are several ways to go about fixing this:


2. Balance and Credit for this user are empty, and the user type is Prepaid. That means he has no funds to cover the call fees. There are several ways to go about fixing this:
*  If the User is postpaid, he should use some Payment method to increase his Balance. [[PayPal]] and [[Payments | Manual Payment]], among others, are good ways to do this.
*  We can change the User type to Postpaid and then we should adjust his Credit. Maybe it is unlimited, maybe some limit exists. But this will allow the User to dial out.


*  If the user is postpaid, he should use some payment method to increase his balance. [[PayPal]] and [[Payments | Manual Payment]], among others, are good ways to do this.
3. The User has no Devices. A Device is necessary in order to dial out. Just create one for this User.
*  We can change the user type to postpaid and then we should adjust his credit. Maybe it is unlimited, maybe some limit exists. But this will allow the user to dial out.


3. We see that the user has assigned a tariff and a type of tariff. The type of tariff is just for informational purposes. Here 'Explanation' tells us that Tariff is empty. That is the reason why the user is not able to dial out. In addition, the user can dial out only to those destinations which have rates. Currently none of them has. You need to add some rates to the existing tariff or assign a non-empty tariff to this user.
'''Note:''' We also see that the User has an empty Tariff assigned. That is the reason why the User will not be able to dial out. In addition, the User can dial out only to those destinations which have Rates. Currently none of them has. You need to add some Rates to the existing Tariff or assign a non-empty Tariff to this User.
 
4. The user has no devices. A Device is necessary in order to dial out. Just create one for this user.




After solving all these issues, we should see:
After solving all these issues, we should see:
 
<br><br>
[[Image:calltracing3.png]]
[[Image:calltracing3.png]]
<br><br>
<br><br>


= Device testing =  
= Device testing =  


The following section lets us choose a device and a call date, and enter the destination we want to test. For example:
The following section lets us choose a Device, Source, Server, Destination and a Call Time we want to test. For example:
 
<br><br>
[[Image:calltracing10.png]]
[[Image:Calltracing3.png]]
 
<br><br>
 
This data means that we are testing a virtual Call from an IP authenticated SIP Device to a number 37061111111 on 2017 September 5th 09:30.
 
This data means that we are testing a virtual call from device SIP/1004 to number 863042438 on 2009 August 26th 00:00.
 
When we click '''Press this button to continue''', we will go to the next page and we will see something like:
 
[[Image:calltracing11.png]]
 
 
 
The '''Details''' section shows us just routine information. We already knew this information, so it is not important.
 
[[Image:calltracing12.png]]
 
 
 
If you see direction as Unknown, it means your number is not in E.164-compatible format. Edit [[Localization]] rules to transform your number to E.164 number format.
 
The '''Localization''' section is much more important.
 
Here we see the device's Location and Applied rule, and the result after localization.
 
 
<big>'''IMPORTANT! Software can't read a user's mind, so it can't know where a user is dialing.'''</big>
 
 
This can be illustrated by this example:
 
A User dials 863042438. After Localization, we see that number is still 863042438 - which means it's somewhere in China. But this is wrong, because the user dialed a Lithuanian number in local format! What does this mean? It means that [[Localization]] is not configured properly. MOR can't show you an error here because there's no way to tell whether it's okay or not.
 
You should decide for yourself. All MOR can do is show you all the information it can get from the call, and it does that.
 
So in order to proceed with the example, we have to set a correct [[Localization]] rule for this number format. After doing this, we will see:
 
[[Image:calltracing13.png]]
 
 
 
Now everything is okay. The localized destination is E.164 compatible. Now MOR understands that it's Lithuania.
 
If we get the following window:
 
[[Image:calltracing14.png]]
 
 
 
... it means we do not have rates or custom Rates for the dialed destination. After adding them, [[Rate Effective From|active]] Rate with other information will be shown:
 
[[Image:calltracing15.png]]
 
 
 
This window also shows us that we do not have a custom rate for this destination. But it's enough to have a simple rate for a destination to be able to dial out or vice versa.
 
We can proceed to the providers:
 
[[Image:calltracing16.png]]
 
 
 
We can see that our provider does not have a Rate for this destination. After adding them, [[Rate Effective From|active]] Rate with other information will be shown:
 
[[Image:calltracing17.png]]
 
 
 
That's it. Now a real call should go out without problems.
 
 


When we click '''Trace Call''', we will go to the next page and we will see something like:
<br><br>
[[Image:New_mor_call_tracing.png]]
<br><br>
Call Tracing Log will show self explanatory warnings, errors (in red colored text), other messages, and an informative summary.
<br><br>
<br><br>


= Conclusion =
To summarize Call Tracing, it is very important to configure Localization properly.
You will see using Call Tracing what is happening and where the call is going.
When rates for user and provider are checked using localized destination, and when all data are in place, there's no obstacle to prevent the call from being sent to the provider.
'''IMPORTANT!''' The green message at the end of Call Tracing does not mean the call will be successful! It only means that MOR will send the call to the provider. The last table shows what string it will send to the provider. Applied Provider Rule parameters (Cut and Add) are also visible in the table.
MOR can't know whether the provider accepts your dial string or not. That depends on how you configured [[Provider Rules]]. Call Tracing shows you the formatted number which is sent to the provider, but you should decide whether or not it is correct.
If a call fails, check [[Users Calls]] or [[Providers Calls]] and check [[Hangupcause Codes]] to find the reason.
<br><br>
=From Accountant=
=From Accountant=


Accountant must have '''Call tracing usage''' permission in [[Accountant_permissions | Accountant permissions group]] to use this functionality.
Accountant must have '''Call tracing usage''' permission in [[Accountant_permissions | Accountant permissions group]] to use this functionality.

Latest revision as of 08:58, 3 October 2017

MOR Call Tracing Overview

This function is for checking the setup of MOR in order to be sure a User will be able to dial out. To set MOR up isn't simple, but we are trying to make it easier with this manual and with improvements to GUI. It often happens that Users miss some important detail while trying to make everything work. Call Tracing will save a lot of head-scratching, and we hope it will be helpful for beginners.

This function can be found in SETTINGS –> Billing –> Function –> Call Tracing. It can be quickly accessed in the Users menu (SETTINGS –> Users) as well. Just click on the Icon call tracing.png icon for a User.

NOTE that Accountant can use this functionality with Call Tracing Usage permission.

In the first window, we have to select which User we want to check:

Calltracing1.png

User testing

The next window shows us whether we have configured everything properly for the selected User. Let's look at each section separately.

The first section shows information special to the User:

Calltracing2.png

Here we see three errors Icon cross.png that prevent the User from operating. Let's say we want to allow a User to make Calls. We will go through each of the errors and fix them.


1. This error tells us that the User is Blocked and so unable to make Calls. We should go to User Details and unblock him.

2. Balance and Credit for this User are empty, and the User type is Prepaid. That means he has no funds to cover the Call fees. There are several ways to go about fixing this:

  • If the User is postpaid, he should use some Payment method to increase his Balance. PayPal and Manual Payment, among others, are good ways to do this.
  • We can change the User type to Postpaid and then we should adjust his Credit. Maybe it is unlimited, maybe some limit exists. But this will allow the User to dial out.

3. The User has no Devices. A Device is necessary in order to dial out. Just create one for this User.

Note: We also see that the User has an empty Tariff assigned. That is the reason why the User will not be able to dial out. In addition, the User can dial out only to those destinations which have Rates. Currently none of them has. You need to add some Rates to the existing Tariff or assign a non-empty Tariff to this User.


After solving all these issues, we should see:

Calltracing3.png

Device testing

The following section lets us choose a Device, Source, Server, Destination and a Call Time we want to test. For example:

Calltracing3.png

This data means that we are testing a virtual Call from an IP authenticated SIP Device to a number 37061111111 on 2017 September 5th 09:30.

When we click Trace Call, we will go to the next page and we will see something like:

New mor call tracing.png

Call Tracing Log will show self explanatory warnings, errors (in red colored text), other messages, and an informative summary.

From Accountant

Accountant must have Call tracing usage permission in Accountant permissions group to use this functionality.