mor x4 manual

629

Click here to load reader

Upload: lankoor

Post on 18-Aug-2015

337 views

Category:

Documents


24 download

TRANSCRIPT

Kolmisoft 2006-2013 1 It is IMPORTANT to note that this manual is compilation of articles from our main data source: http://wiki.kolmisoft.com and current info in this manual can be outdated. In order to get newest info please use online wiki. Kolmisoft 2006-2013 2 Contents MOR X4 new features ........................................................................................................................ 6 Introduction ................................................................................................................................... 47 Who is this product designed for .................................................................................................... 47 Supported Business Models ........................................................................................................... 48 How to make first call ................................................................................................................... 48 Concepts/Definitions ....................................................................................................................... 55 MOR Terminology ......................................................................................................................... 55 Billing Concepts ........................................................................................................................... 59 Billing Logic ................................................................................................................................. 60 Call explained .............................................................................................................................. 61 E.164 ................................................................................................................................. 62 Rounding ................................................................................................................................. 62 Multi-Tax system ......................................................................................................................... 62 What is a PIN? ............................................................................................................................. 65 ASR/ACD ................................................................................................................................. 66 Margin and Markup ...................................................................................................................... 66 What are callgroups and pickupgroups ............................................................................................ 67 Balance and Credit ....................................................................................................................... 68 Why amounts are without VAT? ..................................................................................................... 69 Local Calls ................................................................................................................................. 69 Prepaid Logic ............................................................................................................................... 71 Authentication ............................................................................................................................. 73 Fax over VoIP .............................................................................................................................. 75 Configuration from GUI ................................................................................................................... 77 ReCAPTCHA................................................................................................................................. 84 Payments configuration ................................................................................................................ 89 Default device settings ................................................................................................................. 95 Default user ................................................................................................................................ 97 Accountant permissions ................................................................................................................ 98 Logo change ............................................................................................................................... 100 Currencies ................................................................................................................................ 101 Translations ............................................................................................................................... 104 Global date format ...................................................................................................................... 106 Remove Manual link from admin GUI ............................................................................................. 107 Voicemail ................................................................................................................................ 107 Multi Server support .................................................................................................................... 112 Email settings ............................................................................................................................. 116 Number Manipulation ..................................................................................................................... 121 Localization................................................................................................................................ 121 Provider Rules ............................................................................................................................ 127 DID handling by Localization ........................................................................................................ 131 Users ........................................................................................................................................... 139 User Details ............................................................................................................................... 139 Warning balance ......................................................................................................................... 141 User Blocking ............................................................................................................................. 142 Blocking ................................................................................................................................ 144 Hide Users ................................................................................................................................ 146 Why MOR does not allow to delete users ........................................................................................ 148 How to create User and Device ..................................................................................................... 149 How to change Admin details ........................................................................................................ 149 MOR forgot user password ........................................................................................................... 150 Kolmisoft 2006-2013 3 Minimum contract billing .............................................................................................................. 152 Tariffs .......................................................................................................................................... 153 Directions and Destinations .......................................................................................................... 153 Destinations Groups .................................................................................................................... 154 Block some Destination to User .................................................................................................... 155 Day setup ................................................................................................................................ 158 Entering Rates for Wholesale Tariff ................................................................................................ 159 Rate import from CSV.................................................................................................................. 163 Wholesale Tariff .......................................................................................................................... 173 Entering Rates for Retail Tariff ...................................................................................................... 175 Advanced Rates .......................................................................................................................... 177 Custom Rates ............................................................................................................................. 180 Tariff Transformation ................................................................................................................... 181 Make Retail Tariff from Wholesale Tariff explained ........................................................................... 182 Devices ........................................................................................................................................ 184 Extension lines ........................................................................................................................... 193 Ring several devices at same time ................................................................................................ 193 How to create User and Device ..................................................................................................... 194 Trunks ................................................................................................................................ 194 CLIs (Incoming CallerIDs) ............................................................................................................ 195 ANI/CLI ban system .................................................................................................................... 196 Duplicate call prevention .............................................................................................................. 199 Allow loss calls ........................................................................................................................... 199 Device groups ............................................................................................................................ 200 Call Flow ................................................................................................................................ 201 Which codecs should I choose for devices ...................................................................................... 206 Change Audio/Video Codecs priority .............................................................................................. 209 Authentication ............................................................................................................................ 210 Providers ...................................................................................................................................... 219 Failover provider ......................................................................................................................... 225 Terminators ............................................................................................................................... 226 Provider with several IP ............................................................................................................... 226 Provider connection testing .......................................................................................................... 227 H323 Provider settings ................................................................................................................ 228 Provider with ANI ........................................................................................................................ 228 Configure Provider which can make calls ........................................................................................ 230 Configure Provider with dynamic IP ............................................................................................... 230 Simultaneous call limitation .......................................................................................................... 232 NO ANSWER/BUSY interpretation for providers ............................................................................... 235 Call Routing .................................................................................................................................. 256 LCR ................................................................................................................................ 256 LCR Logic ................................................................................................................................ 258 Call Routing by price ................................................................................................................... 260 Call Routing by priority (Manual LCR) ............................................................................................ 261 Call routing per destination basis .................................................................................................. 263 How to route call to specific Destination through specific Provider ..................................................... 266 LCR/Tariff change based on call prefix ........................................................................................... 267 Prefix finder ............................................................................................................................... 269 Routing by Percent ...................................................................................................................... 270 Why call was not routed through other provider/trunk? ................................................................... 272 DIDs ............................................................................................................................................ 274 DID Management ........................................................................................................................ 274 Assign DID to Trunk .................................................................................................................... 284 Kolmisoft 2006-2013 4 Work flow for DID ....................................................................................................................... 286 DID Billing ................................................................................................................................ 287 DIDs Usage ................................................................................................................................ 291 Personal DIDs ............................................................................................................................. 291 DID with VoxBone using his URI ................................................................................................... 296 Forward DID to External Number .................................................................................................. 297 How to charge DID on a monthly basis .......................................................................................... 297 DID handling by Localization ........................................................................................................ 298 DID Blocking .............................................................................................................................. 299 Dial Plans ................................................................................................................................ 299 Authorization by ANI ................................................................................................................... 303 Calling Card Dial Plan .................................................................................................................. 306 Callback Dial Plan ....................................................................................................................... 308 IVR Dial Plan .............................................................................................................................. 310 Accounting .................................................................................................................................... 311 Invoices ................................................................................................................................ 316 Credit notes ............................................................................................................................... 327 Payments ................................................................................................................................ 330 Vouchers ................................................................................................................................ 333 Flat-Rates ................................................................................................................................ 336 Reporting...................................................................................................................................... 337 Active Calls................................................................................................................................ 337 Last Calls ................................................................................................................................ 341 Users Calls ................................................................................................................................ 344 Users Finances ........................................................................................................................... 345 DIDs Report ............................................................................................................................... 345 Loss Making Calls ........................................................................................................................ 346 Providers Statistics ...................................................................................................................... 346 Providers Calls ............................................................................................................................ 348 Aggregate ................................................................................................................................ 349 First Activity ............................................................................................................................... 351 Quick Stats................................................................................................................................ 351 Simultaneous Calls stats .............................................................................................................. 354 Calls by Source ........................................................................................................................... 355 Login Stats................................................................................................................................ 356 Profit Stats................................................................................................................................ 357 Country Stats ............................................................................................................................. 357 Google Maps integration .............................................................................................................. 359 Balance in phone ........................................................................................................................ 360 Privacy to hide Destination ends ................................................................................................... 362 Troubleshooting ............................................................................................................................. 364 Action log ................................................................................................................................ 364 User actions ............................................................................................................................... 367 Call Tracing ................................................................................................................................ 367 Integrity Check ........................................................................................................................... 375 Hangupcause Codes .................................................................................................................... 377 Hangupcause Sounds .................................................................................................................. 379 Different code send to User compared to received from Provider ....................................................... 380 Call Info ................................................................................................................................ 381 SIP debug info ............................................................................................................................ 383 Asterisk CLI ............................................................................................................................... 384 MOR's Core version ..................................................................................................................... 386 Lots of calls made by System Admin user ...................................................................................... 386 Kolmisoft 2006-2013 5 Maintenance ................................................................................................................................. 387 Lost MOR GUI admin password ..................................................................................................... 388 Where I can get my serial key from ............................................................................................... 388 Testing ......................................................................................................................................... 388 VoIP Bandwidth Calculator ........................................................................................................... 388 Payment gateways ......................................................................................................................... 389 Other functionality ......................................................................................................................... 400 IVR system................................................................................................................................ 400 IVR Greeting for DID ................................................................................................................... 407 Voicemail ................................................................................................................................ 409 Dial Local ................................................................................................................................ 414 PBX Function External DID ........................................................................................................... 418 Ring-Groups ............................................................................................................................... 420 Fax2Email ................................................................................................................................ 423 PhoneBook................................................................................................................................ 427 Speed Dials ................................................................................................................................ 429 Backup system ........................................................................................................................... 431 Data import ................................................................................................................................ 433 CDR Import ................................................................................................................................ 435 CDR Rerating ............................................................................................................................. 440 Online registration ...................................................................................................................... 442 Online registration customization .................................................................................................. 444 Quick Forwards ........................................................................................................................... 444 Quickforwards rules..................................................................................................................... 447 Transfers with MOR ..................................................................................................................... 449 GUI on Mobile Devices ................................................................................................................. 450 PBX connection to MOR ................................................................................................................ 451 MOR API ................................................................................................................................ 462 Cron actions ............................................................................................................................... 467 MOR Addons ................................................................................................................................. 469 Calling Cards Addon .................................................................................................................... 469 Callback Addon ........................................................................................................................... 508 Auto-Dialer Addon ....................................................................................................................... 521 Reseller Addon ........................................................................................................................... 528 Reseller Pro Addon ...................................................................................................................... 533 Manual for Resellers .................................................................................................................... 535 SMS Addon................................................................................................................................ 546 Recordings Addon ....................................................................................................................... 548 Mobile Number Portability Addon .................................................................................................. 553 Payment Gateway Addon ............................................................................................................. 555 Monitorings Addon ...................................................................................................................... 580 Call Shop Addon ......................................................................................................................... 592 Provider billing addon .................................................................................................................. 610 Tutorials ....................................................................................................................................... 612 Usual configuration sequence ....................................................................................................... 612 How to configure 911 service ....................................................................................................... 618 How to make several connections from one IP ................................................................................ 620 How to forward calls when device is offline ..................................................................................... 624 How to be secure using MOR ........................................................................................................ 625 Kolmisoft 2006-2013 6 MOR X4 new features AlertsDescription Alerts functionality dedicated to take some actions about issues in your system which may cause aproblem.YoumayblockUser,disableProvider,changeLCRforUserorsimplysenda notification to specified Group of Contacts.You are able to follow these parameters:ASR Answer-Seizure Ratio.ACD Average Call Duration.PDDAveragePostDialDelay.Thetimebetweenpunchinginthelastdigitofa telephone number and receiving a ring or busy signal.TTC(TimetoConnect)(DURATION-BILLSEC)Averagetimebetweenreceivingaring signal and answer to the call.BILLSEC Sum of calls bilsec.TOTAL CALLS Sum of all calls.ANSWERED CALLS Sum of answered calls.NOT ANSWERED CALLS Sum of not answered calls (FAILED, BUSY, NO ANSWER).SIMULTANEOUS CALLS Number of simultaneous calls (only applies to users).PRICE SUM Sum of calls price (only applies to users and providers).And it is possible to make actions for these types of MOR Objects or send notification about it:UsersoAlloPostpaidoPrepaidoOne UserProvidersDevicesDestinationsoOne Destination by prefix.oFew Destinations by prefix and % sign. Eg. 93%, 3706% and so on.Destinations Groups Kolmisoft 2006-2013 7 Usage Go to ADDONS > Monitorings > Alerts Here you can see list of all created Alerts and their main information like is Alert active? When it was Raised/Cleared last time? What value was at Alert/Clear... Click onAdd new Alert link to create an Alert or click onicon to change settings of existing Alert.Kolmisoft 2006-2013 8 You will see a window like this: GeneralObject Type select which Object you want to follow.Object Name pecify name/prefix of Object.Parameter choose which parameter should be followed.AlertTypeABSmeansthatabsolutedatavalueswillbetakenfromspecifiedtime period.Ignore if Calls = indicate calls sum when system should ignore Alert if calls sum is more than written.Group to Notify select Group of Contacts who should be informed about Alert/clear.Kolmisoft 2006-2013 9 AlertAlert if = indicate Parameter value when system should raise Alert if value is more than written.Disable Object check if you want to disable selected Object on Alert.LCR on Alert select LCR which one should be used after AlertNotify On Alert via Email check if you want that specified Group will receive an email notifications about Alerts.ClearDisable Clear when alert is raised, it will never be cleared.Clear if = indicate Parameter value when system should Clear Alert if value is more than written.Enable Object check if you want to enable selected Object on Clear.LCR on Clear select LCR which one should be used after Clear.Notify On Clear via Email check if you want that specified Group will receive an email notifications about Clear.PeriodYou can select different time periods for each alert. Note: period has no effect when parameter SIMULTANEOUS CALLS is chosen.Comment additional notes. Examples Send notification and change LCR on Alert Parameter: TOTAL CALLSObject Type: UserObject Name: PrepaidAlert if >=: 300Clear if Setup > SettingsClickFunctionalitytabandhereyouareabletosetFAScontrolsettingsforActiveCalls: Kill Call if PDD more than set this value if you want to terminate calls that have high pddvalue(thiscouldindicateabadqualityofprovider).ZerovaluemeansthatFAS control functionality is off.Kill Call if PDD less than set this value if you want to terminate calls that have low pdd value(thiscouldindicatethatproviderusesFAS).ZerovaluemeansthatFAScontrol functionality is off.NOTE: PDD will be checked when the Call is Answered.Kolmisoft 2006-2013 12 Useful to know Betamax This is very often happens with Betamax company group providers: http://backsla.sh/betamaxVoice Trading http://www.voicetrading.com/This provider supports 3 quality routes:Dialing number in E164 format: GREYPrefix 00: STANDARTPrefix 000: PREMIUMGREY plan has FALSE ANSWER problem. Call Queues Description Call queue is a feature that allows an unlimited number of callers to wait for an available sales representative or for resources to become accessible to assist them. This allows you to provide each customer with the same quality service. In addition, it ensures your customers wont end up in voicemail.Queues consist of: Incoming calls being placed in the queue.Members that answer the queue (extensions or users that login as agents).A strategy for how to handle the queue and divide calls between members.Music played while waiting in the queue.Announcements for members and callers.Usage Queue Options Queue Name name of Queue. Assigned DID(s) quantity of DIDs, which are assigned to current Queue. Extention a short number by which this queue can be reached; must be unique in the Kolmisoft 2006-2013 13 system. Server allows to choose server in multiple servers system. Server id on which server queue application will be executed.Ring Strategies Calls are distributed among the members handling a queue with one of several strategies: ringall: ring all available channels until one answers (default) roundrobin: take turns ringing each available interface leastrecent: ring interface which was least recently called by this queue fewestcalls: ring the one with fewest completed calls from this queue random: ring random interface rrmemory: round robin with memory, remember where we left off last ring pass Queue Weight for comparing with other queues, higher weights get first shot at available channels when the same channel is included in more than one queue. Autofill makes sure that when the waiting callers are connecting with available members in a parallel fashion until there are no more available members or no more waiting callers. Skip Busy Agents lets do not send calls to members whose devices are known to be 'in use'(Note: only the SIP channel driver currently is able to report 'in use').Fail Over Actions set action what to do after Queue:HangupTransfer to ExtensionTransfer to DIDTransfer to DeviceAgent Options CID Name Prefix The CID Name Prefix is used to prefix the caller ID of callers in the queue with the value entered in this field. This is often used when agents are members of multiple queues so that they know which department a person has called (for example, a CID may be prefixed with "Sales" or "Tech Support").Report Hold Time If you wish to report the caller's hold time to the member before they are connected to the caller, set this to yes. Agent Announcement An announcement announce may be specified which is played forthe member as soon as they answer a call, typically to indicate to them which queue this call hould be answered as, so that agents or members who are listening to more than one queue can differentiated how they should engage the customerAgent Delay If you wish to have a delay before the member is connected to the caller (orKolmisoft 2006-2013 14 before the member hears any announcement messages), set this to the number of seconds to delay.Agent Timeout This timeout specifies the amount of time to try ringing a member's phonebefore considering the member to be unavailable.Retry How long do we wait before trying all the members again? Wrap-Up-Time After a successful call, how long to wait before sending a potentially freemember another call (default is 0, or no delay)Allow hangup by * allow callee to hang up by pressing Static Agents To add Static Agent click on Add new Static Agent link and choose Device and Penalty.PenaltiesQueue members can be defined as having a penalty - e.g. member => SIP/200,1 member => SIP/201,2 member => SIP/202,3 member => SIP/203,2 If the strategy is defined as 'ringall', then only those available members with the lowest priorities will ring. In the example above, if 200 is not busy, then only 200 will ring. If 200 is busy, then only 201 and 203 will ring. If 200, 201 and 203 are busy, then 202 will ring.NOTE that if extension 200 does not pick up it will not automatically go to extension 201. It will keep ringing 200 until they pick up. It will only go to the next extension if the current extension is either busy or unavailable. Caller Options Max Callers Maximum number of people waiting in the queue (0 for unlimited). Join Announcement The Join Announcement drop-down menu is used to select a sound file to be played back to the caller before they are dropped into the queue. This file must be pre-recorded or uploaded to the system. This announcement is optional, but will usually state that the caller is being placed into a queue, and that their call will be answered in priority sequence.Ringing instead of MOH ring instead of playing MOH.Music On Hold Class Musicclass sets which music applies for this particular call queue. Ring at once when Agent is ringing stops MOH and rings once an agent is ringing (Asterisk Trunk). Kolmisoft 2006-2013 15 Join Empty This setting controls whether callers can join a queue with no members. paused - a member is not considered available if he is pausedpenalty - a member is not considered available if his penalty is less thanQUEUE_MAX_PENALTY inuse - a member is not considered available if he is currently on a callringing - a member is not considered available if his phone is currently ringingunavailable - This applies mainly to Agent channels. If the agent is a member of the queue but has not logged in, then do not consider the member to be availableinvalid - Do not consider a member to be available if he has an "invalid" device state. This generally is caused by an error condition in the member's channel driver.unknown - Do not consider a member to be available if we are unable to determine the member's current device state.wrapup - A member is not considered available if he is currently in his wrapuptime after taking a call.Leave When Empty if you wish to remove callers from the queue when new callers cannot join, set this setting to one of the same choices for 'Join Empty' described above. Allow hangup by * allow caller to hang up by pressing *IVR Brake-Out Menu A context may be specified, in which if the user types a SINGLE digit extensionwhiletheyareinthequeue,theywillbetakenoutofthequeueandsenttothat extension in this context.Max Wait Time 'timeout' sets the time in seconds that a call will wait in the queue before it is routed to the next priority in the dialplan. It defaults to 300 seconds (5 minutes). Caller Announcements Repeat Frequency How often to announce queue position and/or estimated holdtime to caller.Min. AnnounceFrequencyTheabsoluteminimumtimebetweenthestartof eachqueue positionand/orestimatedholdtimeannouncementThisisusefulforavoidingconstant announcementswhenthecaller'squeuepositionischangingfrequently(seeannounce-frequency).Announce Position Queue position announce? Valid values are "yes," "no," "limit," or "more." If set to "no," then the caller's position will never be announced. If "yes," then the caller's position in the queue will be announced to the caller. If set to "more," then if the number of callers is more than the number specified by the announce-position-limit option, then the caller will hear that there are more than that many callers waiting (i.e. if a caller number 6 is in a queue with the announce-position-limit set to 5, then that caller will hear that there are more than 5 callers waiting). If set to "limit," then only callers within the limit specified by announce-position-limit will have their position announced.If you have specified "limit" or it "more" for the announce-position option, then the following value is what is used to determine what announcement to play to waiting callers. If you have set Kolmisoft 2006-2013 16 theannounce-positionoptiontoanythingelse,thenthiswillhavenobearingonqueue operation. Announce Hold Time Should we include estimated hold time in position announcements? Either yes, no, or only once. Hold time will be announced as the estimated time, or "less than 2 minutes" when appropriate. RoundSecondsWhat'stheroundingtimefortheseconds?Ifthisisnon-zero,thenwe announce the seconds as well as the minutes rounded to this value. Periodic Announcements Thisblockallowsamessagelike"Thankyou forholding,yourcallisimportanttous."to be played at regular intervals while a caller is in the queue.Repeat Frequency How often to make any periodic announcement (see periodic-announce)Random Should the periodic announcements be played in a random order? Default is no.Relative If set to yes, the periodic announcment frequency will be timed from the end of each announcmentratherthanfromthestartofeachannouncment.Thisdefaultstooff.Announcment sound message Vizualization From Reseller/Reseller PRO Reseller/Reseller PRO is not able to use Queue functionality.Kolmisoft 2006-2013 17 From Accountant AccountantcanmanageAdminsQueuesiftherearesetManageQueuespermissionin Accountant permissions.Not supported additional functionalityDynamic Agents (users who can login/logout to/from queue)Queue usage statisticsSuchfunctionalityisnotplanned,becauseMORisnotpropersolutionforCallCenter environment with high-load. Queues in MOR are mainly for small office use.This can change due to high-demand from our Clients. Music on Hold Description It is recorded music being played to fill the silence that would be heard by telephone callers who have been placed on hold. It is especially common in situations involving customer service. Any caller will hear music if it is set so. Who can configure and use Music on Hold?Only admin can configure Music on Hold, create, update and delete sounds.UsageGo to ADDONS > PBX functions > External DIDs > Music On Hold. Here you can see the list of current sound files added which will be played while the caller is on hold: Kolmisoft 2006-2013 18 To create new record, clickAdd new and type in name, description, choose ivr sound files folder and select if files in that folder are played randomly or in order: You can also change details by clickingicon and delete music on hold by clickingicon.When you have created Music on Hold, you can now assign the selected class to a Queue. Simply go to Settings > DIDs > PBX functions> Queues and assign class byselecting it from dropdown in Caller Options section: Server is overloaded Description MOR constanty monitors it's servers for various performance stats:Hard disk IOCPUMOR according to the complexity of the task may sometimes not allow you to do some tasks during high workloads with this error message:Server is overloaded, please try later. This means that your server(-s) are busy and you should retry the tasks later.Kolmisoft 2006-2013 19 Protection against high loads is implemented in all statistics pages.ConfigurationGo to SETTINGS > Setup > Settings Click on Server load tab and you will see settings: Here you can set parameters which defines when Server is overloaded. Those Settings will be applied to GUI and Database Servers. Set 0 if you want to disable checking.Blacklist functionality Description Blacklist functionality Dynamic Routing based on smart logic which puts a 'score' on the call by itsSRC,DSTorRTPIPandallowsroutingcallwithhighscoreoverdifferentroute.This functionalitygivesyouanabilitytodefineLCRasBlacklistProvidersgroup.TheseProviders works like any other Provider in MOR system. MOR reroutes all the calls, that have a score more than a defined threshold, to this Blacklist LCR. Kolmisoft 2006-2013 20 This functionality is useful when system owner wants to route 'suspect' calls through different route than 'normal' calls.Example:callsfromsuchcountriesasNigeria,Sudan,etc,basedontheirIP/CallerIDcanbe marked as 'suspects' and routed to some IVR or to the dead-end.Configuration You can manageSingle User settings in User DetailsGlobal settings in ADDONS > Monitorings > Settings Blacklist Feature enabled enables Blacklists functionality in all system.Default Blacklist LCR LCR with Balcklist Providers.Default Routing Threshold sum of SRC, DST and RTP IP limit. If SRC, DST or RTP IP scores sum,receivedduringthecall,isbiggerthanDefaulltThreshold,callwillberoutedthrough selected Blacklist LCR.Default scores Default scores of SRC, DST or RTP IP. There will be cases where MOR will not find a score for a given SRC, DST or RTP IP. In each of the cases MOR will add the missing values from these settings.UsedefaultblacklistingrulescheckthistouseBlacklistingScriptforSRC,DSTorRTPIP scoring.Kolmisoft 2006-2013 21 Thisfeatureisdesignedtostopthescoremanipulationdonebytheblacklistingscript (Intelligence). This feature is used in the situation where we want to disable the score number manipulation done by the blacklisting script but still keep the blacklist functionality.As an example, maybe we will notice in the future that we have incorrectly setup the blacklisting script rules and as a result we are getting some false positives into our blacklist. In this case we don't want to completely disable the blacklisting feature but just disable the blacklisting script until we have had enough time to go back to the CDR analyses and figure out the correct values that need to be defined for the correct functioning of the blacklisting script.If the Use default blacklisting rules is set to no then the MOR system should continue to add source numbers, destination numbers and source IP addresses to the blacklist database, but the blacklist script should not run and change the database values.Blacklisting Script (Intelligence)MOR does not know nothing about the script and does not care about it. This script is INDEPENDENT from MOR.What it will do is to try to figure out what a blacklisted call could look like. For example it could be that a customer of a customer tries to call one specific number more than 10 times a day or more than 5 times within one hour. Or there are many calls generated by one source phone number or one source IP media. It all depends on experience and assumptions and that may be different for all customers.To use default blacklisting rules you have to create your own script:Script can be done in any language.Script can be placed anywhere in the systemIt is advisable to run this script periodically with CronIt should analyze CDRs and make decisions based on various criteria.After that it should populate appropriate DB fields to put scores for various values.The script to change scores could work like this: If a destination_number was called more than DST-n1 times within DST-t1 minutes then DST-Score = DST-Score + DST-v1 If a destination_number was called more than DST-n2 times within DST-t2 hours then DST-Score = DST-Score + DST-v2 If a source_number was calling more than SRC-n1 times within SRC-t1 minutes then SRC-Score = SRC-Score + SRC-v1 If a source_number was calling more than SRC-n2 times within SRC-t2 hours then SRC-Score Kolmisoft 2006-2013 22 = SRC-Score + SRC-v2 If a source_IP_number was calling more than SRC-IP-n1 times within SRC-IP-t1 minutes then SRC-IP-Score = SRC-IP-Score + SRC-IP-v1 If a source_IP_number was calling more than SRC-IP-n2 times within SRC-IP-t2 hours then SRC-IP-Score = SRC-IP-Score + SRC-IP-v2 Variables like DST-n1 to SRC-IP-v2 need to be defined manually.Example If a destination_number was called more than 5 times within 60 minutes then DST-Score = DST-Score + 100 or If a source_IP_number was calling more than 40 times within 5 hours then SRC-IP-Score = SRC-IP-Score + 100 NOTE: if you want to create such script, please contact Kolmisoft, we will consult how to do this, will provide necessary database info and all other details. Webphone addon About Webphone addon lets users make calls directly from browser. Kolmisoft 2006-2013 23 Just Google Chrome (from version 27.0.1453.94), Mozilla Firefox (from version 21), Opera (from version 12.15) and Internet Explorer (from version 10) are supported.Settings To use this addon you have to install Java! You will find Webphone addon in: ADDONS -> Webphone: "Encoded SIP Server" and "Encoded Logo URL" are provided by Kolmisoft staff. Webphone will not work if these lines will be filled with plain text.NOTE: Webphone can be used for calls just by user user type.Webphone addon for Users If you want let to use Webphone addon for user you have to select Yes on Allow to use for this User option in User Details window Webphone block. By default this option is set as No. It is not possible to select Yes if user do not have SIP Devices.Defaultdeviceissetforusersautomatically.IfDefaultDeviceisSIPthenitisalsosetfor Webphone. If default device is not SIP then device for webphone will be the first from the SIP devices list. If there is no SIP device at all, you will see "Do not use webphone" selection. You can also select it yourself if you do no want to use webphone. You can always change webphone device manualy.If userwanttoseeWebphoneonhismainpage,hehas tochooseSIPDevicebyhimself in PERSONAL MENU > Details Webphone block.Webphone addon for Resellers To enable Webphone for Resellers Admin have to create and/or edit Reseller Permissions group and assign it to Reseller. With permissions Reseller is able to use Webphone addon as admin, Kolmisoft 2006-2013 24 except Encoded SIP Server - this option can be set just by Admin. Webphone usage for reseller users is same as Admins Users.Webphone addon for Accountant To enable Webphone for Accountants Admin have to create and/or edit Accountant permissions group, set read or write rights and assign it to Accountant. Accountant cannot change Webphone addon settings. He is able just manage usage for Admins Users. Calls Archiving Description When there are many old calls that are no longer useful, they can be archived and moved from Last Calls page to STATISTICS > Calls > Archived Calls.When old calls are in another database table, normal system's work increases tremendously. Here you can see similar table to Last Calls, so you can check calls information at anytime you want. You can find more information about each field in Last CallsSettings Archiving options can be set in SETTINGS -> Setup -> Settings -> Various tab. Kolmisoft 2006-2013 25 Archive Calls older than - this is the number of days. When call is older than the number you set, it will be archived and moved to Archived Calls. Archive Calls every day at - this is the time when Background Task takes place and calls from Last Calls are moved to Archived Calls. Archive Calls till - if there are many old calls, it will take time to archive all of them. You may need to set the time when background task no longer proceeds and the action is done.NOTE:youcancheckthecompletionofcallsarchivingprocessandotherinformationin Background Tasks. Time Format Starting fomr MOR X4 time format can be changed to market standard. Showing time in mm:ss instead of hh:mm:ss, for example, not 02:13:42 but 133:42. Aggregate Description Aggregate statistics provide brief information about terminators and originators, ASR, ACD. Only callsroutedviaTerminatorsareincluded.Everycallmadefromeveryusertoeverydifferent terminator is in the statistic so there may be the same prefixes repeated if grouping by prefix is not selected.NOTE: search by Admin is not available because Admin's function to make calls is deprecated.Usage Go to STATISTICS > Calls > AggregateKolmisoft 2006-2013 26 Here you are able to see: In search filter you can choose time period, which originator and/or terminator you want to see. Alsoyoucansearchstatisticsbyprefix.ToseeresultsatleastoneoptionOrig.orTerm.of Customer must be checked.Available details If Destination is checked, the destination countries are shown in statistics sorted by prefix.If Orig. is checked, calls are additionally grouped by user.If Term. is checked, calls are additionally grouped by terminator.If Orig. Price is checked, show additional collum with originator price.If Term. Price is checked, show additional collum with terminator price.If Orig. Billed time is checked, show additional collum with originator billsec.If Term. Billed time is checked, show additional collum with terminator billsec.If Destination is checked, show additional collum with Destination name. Group by prefix - calls are grouped by prefix.Kolmisoft 2006-2013 27 Group by direction - calls are grouped by destinations subcode. If Orig. and Term. are unchecked and Group by direction selected, calls are grouped by country. Finally you are able export results to CSV file.From Reseller PRO SimpleresellerisnotabletoviewAggregatestatistics.ResellerPROmusthaveProviders assigned to Terminators. LCR Time Periods Sometimes there is such demand to change LCR for some time period. This functionality gives you an ability to do that. Go to LCRs list and pressicon. Here time periods can be set. Time period defines the exact time period LCR will be active. There is a limit of five periods in one LCR. Rest of the time will be used main LCR.Examples 1.Select Date from 1 of January to 28 of February and choose Hour : Minute from 09:00 to 18:59. Selected LCR will be used from 1 of January till 28 of February at time from 09:00 till 18:59.2.Select just Hour : Minute from 19:00 to 08:59 and selected LCR will be used every day at time from 19:00 till 08:59.3.Select Weekday from Monday to Friday and choose Hour : Minute from 13:00 to 15:59. Selected LCR will be used every week from Monday till Friday at time from 13:00 till 15:59.Kolmisoft 2006-2013 28 Copying LCRs between resellers Sometimes you need to make a LCR which takes quite a long time to make. If you have made a similar one before you can just copy it and change appropriate details.Go to SETTINGS -> Billing -> LCR -> Copy LCR You will see this window: Choose Original LCR reseller and Cloned LCR reseller and click Clone button.Please note that LCR will not be allowed to copy if reseller B is not allowed to use Providers which are used by Reseller A. CPS Limitation New option in device settings to limit the number of calls during defined time period. Provider billing addon Description Provider billing addon allows reversed billing - it counts provider's balance which increases when admin or reseller makes a call through it. This add-on can be used in the following cases:Provider sends you a bill/ invoice for the calls and you can check if it is correct. Amount shown in Provider billing section should match the invoice from your provider (this can be applied in all VoIP business models where you use some voice traffic suppliers).Providerisyourclientandsupplier.Intheendofthemonthaccordingtobilateral agreements you just check the overall balance (this is usually applied in VoIP Wholesale business).Kolmisoft 2006-2013 29 If you use GSM gateways for termination, adding the time limit per day allows you to avoid clients hearing that the SIM card balance expired as MOR automatically routes the call to the next available GSM gateway (this is used in VoIP Termination business using GSM gateways/SIM banks)BalancesTo see all Providers balances, go to ADDONS -> Provider billing. By clickingEdit you will be lead to Provider's edit window. In General Providers settings you can set Provider balance limit. It is the limit of balance that can be reached by the provider. After hereachesthespecifiedbalance,callsaren'tsentthroughthisprovideranymoreProvider has balance which increases when call goes over this Provider. E.g. Provider receives money for the calls over him.If Provider is assigned to the User then such Provider can make calls. When Provider (which is assignedtotheUser)makescalls,suchcallsgoesoverotherProvidersandUser's(towhich Provider is assigned) balance is decreased.IMPORTANT!Provider'sbalanceandUser'sbalancearetwodifferentvalues.Theyarenot connected and do not impact each other. They change independently of each other.Manual payment for Provider balanceTo add manual payment for provider in main provider billing addon window clickand you will be lead to this window: Kolmisoft 2006-2013 30 Click Proceed: Click Confirm. You will be redirected to Payments window and see this payment if everything is correct.Please note that adding positive Amount will decrease provider's balance and adding negative will increase it. Balance - amount = new balance. Reseller can use this feature only on that reseller's providers.Limit to device or provider per day After you were lead to provider's edition page you can select a minute limit per day for provider. You will find it in Advanced block. Kolmisoft 2006-2013 31 If the limit is exceeded that provider is disabled which means it is not available to make calls through it anymore. If you add a value of zero, no limit will be applied.ToapplythisfunctionalitytodevicegotoSETTINGS->Setup->Defaultdeviceandsee Advanced block.This functionality is available only if provider billing addon is enabled. Quick Providers changes About Pageforyourcomforttoupdatefew Providersdetailsatonce.Inthispageyoucanquickly update Providers Tariffs, Call Limit, Call Timeout, Ringing Timeout and Time limit per day.Usage To add some quick changes for Providers go to SETTINGS > Billing > Providers > Quick Changes. Here you can see a list of all Providers and update some of their details: Changes will be applied just for those Providers, which you can see in current page.Kolmisoft 2006-2013 32 Data import User/Device/DID/CLI importYou must import the data in the following order from CSV files:1. Users data 2. Devices data 3. DIDs data Import Devices from CSV link is disabled while Users data is not imported. Import DIDs from CSV link is disabled while Devices data is not imported.CLIs data can be imported for already existing Devices by Device ID or for just imported Devices by Temporary Device ID (which is in SETTINGS -> Users -> Import).CSV file formatPlease note that such details like tariff, LCR, Localizations, IDs should be specified in csv instead names.Example you have LCR called "My first LCR" this LCR ID is 2. You should specify in csv 2, but not My first LCR.Other way if you will not specify ID system will not find it.You can upload your data from a CSV file that has the following structure: 1.Each record is started in a new line. 2.Each piece of record information is separated by commas (see the example). 3.Text is enclosed within inverted commas (for example: "name"). 4.Numbers are written without inverted commas (for example: 4). 5.Thefirstlinecanbeusedforyourownneeds,suchasfornamingeachfieldof information. If you use this line, do not select the "include first line?" option when asked.For example: We have a CSV file named example.csv with the contents:"id", "username", "password", "e-mail" 1, "username1", "verySecretPassword", [email protected] Kolmisoft 2006-2013 33 2, "username2", "34r34r4232", [email protected] 3, "username3", "23er29923wjwe", "[email protected]" Explanation: Thefirstlineisusedinthiscasefornamingthefields,sowhenasked,donotselectthe "include first line?" option. (If you won't use the first line for naming the fields, please do select "include first line?") Theotherthreelines(starting1,2,3)arefordatarecords.Eachrecord(thefirstoneis:1, "username1", "verySecretPassword", "[email protected]") represents: 1 - user id. "username1" - user's username. "verySecretPassword" - user's password. "[email protected]" - user's e-mail. Your CSV file can have any number of lines with any number of fields (each line must have the same number of fields).P.S. The file should not have any other symbols than those mentioned above. Be careful, as some editors can add their own formatting symbols. In Windows we recommend using Notepad, and in Linux: gedit, kedit, nano.Here are some examples:Users CSV file example: 38,2,0,"NULL","NULL",TRUE,"11420471-2-03","ExampleZRt","ExampleZRt","exampleexample. 11","76/356-650""[email protected]",04/06/0701:48PM,""en", 97,20,0,FALSE,TRUE,5,0,04/06/07,"NULL","NULL",0,FALSE,04/06/07,"Lajosmi",6050,1,0,1,1,TRUE, "NULL","NULL",3 45,2,0,"95757bfa00bf85b17921d709b5af0234","NULL",TRUE,"12969247-2-03","Example kos", "ExampleExample,Kft","Example's38","70/235-45-89","[email protected]", 04/06/0911:28AM,"", "en",97,20,0,FALSE,TRUE,5,0,04/07/09,"NULL", "NULL", 0,FALSE,04/06/09, "Kecexample",6000,1,0,1,1,TRUE,"NULL","NULL","NULL" 2138,2,0,"cc1b3ae8986559b10786d6ea73912bd5","NULL",TRUE,"11871633-2-03","Kos Tas","KsKft","Alsast","20/229-36-78","[email protected]",12/13/0709:42AM,"","en", 97,20,0,FALSE,TRUE,5,0,12/13/07,"NULL","NULL",0,FALSE,12/13/07,"Sirly",6031,1,0,1,1,TRUE ,"NULL","NULL","NULL"Kolmisoft 2006-2013 34 InthefirstcolumnisaTemporaryUser'sID;theothercolumnsrepresentotherdata.As mentioned above, it does not matter in which order your data is represented in the CSV file.It only matters that each column (the data between commas) represents the same data value (id, email, password or other).Devices CSV file example:38,38,76824435,"3676586421","asddsau.12","jamaica","[email protected]",TRUE, "dynamic","sip",TRUE,"NULL","NULL","NULL","NULL","NULL","NULL","NULL","NULL","NULL", "NULL", "NULL", "NULL","NULL","NULL"45,45,76846301,"3676886421","fghhgfu.","ergerSiP","[email protected]",TRUE, "dynamic","sip",TRUE,"NULL","NULL","NULL","NULL","NULL","NULL","NULL","NULL","NULL", "NULL","NULL","NULL","NULL","NULL" 2138,2138,76505921,"3676505921","jkllkju.12","treK","[email protected]",FALSE,"dynamic", "sip",TRUE,"NULL",FALSE,FALSE,10,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,FALSE,,FALSEThe first column here represents "id", the second "user_id", and the others represent other data. YOUR ORDER CAN BE DIFFERENT. The main thing is that each type of data (email, password, id...) must be in the same column. When you are asked to provide data when importing, be sure to assign the correct data from CSV for each column and MOR will know which column represents which data.Dids CSV file example:37067531061,38,38 37065431061,45,22 37062431031,2138,2138 In this example I have used the first column for DID, the second for Temporary User ID, and the third for Temporary Device ID. Your data order can be completely different. You just need to select the correct values when asked.Importing dataFirstly, from the MOR Graphical User Interface (GUI), navigate to: Settings -> Users -> Import. Kolmisoft 2006-2013 35 Temporary User ID & Temporary Device IDThese fields are necessary to map DIDs to Devices and Devices to Users.Temporary IDs can be integer digits only.Example:You have some other system with some user_ids, device_ids, DID_ids. You export them into CSV files. The relations between them are kept by these IDs, so importing them to MOR will keep these relations.First you need to import a User with some temporary ID, then make sure this ID is near each Device you are trying to import. Select this ID as Temporary User ID when importing Devices. That way these devices will be mapped to this User.Importing usersTo import users, click on the "Import Users from CSV" link: Now locate the CSV file in your local system by clicking the "Browse" button. As indicated above, don't click the "Include first line?" checkbox if you have used the first line for commenting on the fields. Click on the "Upload file" button.Kolmisoft 2006-2013 36 In next menu, please fill in the requested data (you should select the correct field from your CSV file). You must selecta field for each selection box marked with an asterisk (*) symbol. Having finished, press the "Assign columns" button. Onthenextpage,checkwhetherall thedatawasassignedcorrectly.Ifnot,clickthe"Back" buttonandcorrectthemistakes.Ifallthedatawasassignedcorrectly,clickthe"Confirm columns" button. After the "Columns assigned" notification informs you that data successfully imported.NOTE: When you are going to import CSV file, which includes Tariff and/or LCR, the IDs of Tariff and LCR should be specified in CSV file.Where to find ID of Tariff or LCR? Just go to some of them and press on edit icon, where Browser navigator bar will show full link with location, last number is ID. Kolmisoft 2006-2013 37 Having completed all these steps, you should see a page similar to this: Importing devices Click on the "Import Devices from CSV" link and follow the same procedure for uploading a CSV file as in the "Importing users" section. That is, locate the CSV file in your local system by clicking the "Browse" button. As stated before, don't click the "Include first line?" checkbox if you have usedthefirstlineforcommentingonthefields.Clickonthe"Uploadfile"button.Now you should see a menu similar to this: Kolmisoft 2006-2013 38 In this menu, once again select a matching field from your CSV file for each selection box. It is very important to correctly select Temporary User ID and Temporary Device ID, because these fields are necessary to map DIDs to Devices and Devices to Users.NOTE: When you are going to import CSV file, which includes Location, the name of Location should be specified in CSV file.Having finished selecting the fields, press the "Assign columns" button.Once the columns are assigned, check whether all the data is correct. If not, press the "Back" button and correct the mistakes. Now, if you haven't made any mistakes, you should see two tables similar to these: Importing DIDsClick on the "Import Devices from CSV" link and follow the same steps for uploading a CSV file as in the "Importing users" section. That is, locate the CSV file in your local system by clicking the "Browse" button. As stated before, don't click on the "Include first line?" checkbox if you have used the first line for commenting on the fields. Click on the "Upload file" button. Now youKolmisoft 2006-2013 39 should see a menu similar to this: SelectallmatchingfieldsfromyourCSVhere.ItisveryIMPORTANTtoselecttheCORRECT TemporaryUserIDandTemporaryDeviceID!Havingselectedeverythingcorrectly,clickthe "Assign columns" button. In the next page, if all imported data is assigned correctly, click the "Confirmcolumns"button.Ifyouhaven'tmadeanymistakes,youshouldnowseea"DIDs successfully imported" message.Importing CLIsCLIs data can be imported for already existing Devices by Device ID or for just imported Devices by Temporary Device ID.Click on the "Import CLIs from CSV" link and follow the same steps for uploading a CSV file as in the "Importing users" section. That is, locate the CSV file in your local system by clicking the "Browse" button. As stated before, don't click on the "Include first line?" checkbox if you have used the first line for commenting on the fields. Click on the "Upload file" button. Now youKolmisoft 2006-2013 40 should see a menu similar to this: SelectallmatchingfieldsfromyourCSVhere.ItisveryIMPORTANTtoselecttheCORRECT DeviceID(ifitisselected"UseDeviceID")orTemporaryDeviceID(ifitisselected"Use Temporary Device ID")! Having selected everything correctly, click the "Assign columns" button. In the next page, if all imported data is assigned correctly, click the "Confirm columns" button. If you haven't made any mistakes, you should now see a "CLIs successfully imported" message.You can now check whether all your data has been imported.To check users, go to: SETTINGS > Users.To check devices, go to: SETTINGS > Users > Devices.To check DIDs, go to: SETTINGS > Billing > DIDs.To check CLIs, go to: SETTINGS > Billing > Devices > CLIs.Explanation of IDsMany users find it difficult to understand what User_ID or Device_ID mean in Data Import.These are temporary IDs created only for import purposes. These IDs have NO relation to User ID/Device ID in the Users/Devices windows of the MOR system.Kolmisoft 2006-2013 41 The workflow of Import is:1. We have Users/Devices/DIDs.2. We create a separate file with Users and add a unique ID to every User. The ID is NOT related to User ID in MOR DB/GUI.3. We create a separate file with Devices and add a unique ID to every Device. The ID is NOT relatedtoDeviceIDinMORDB/GUI.NeareachdeviceweaddatemporaryUserIDfrom previous file, which shows which Device belongs to which User.4. We create a separate file with DIDs and near each DID add a User_ID/Device_ID that shows which DID belongs to which User/Device.5. We import the User file, and MOR remembers the temporary User_ID.6.WeimporttheDevicefile,andMORremembersthetemporary Device_IDandchecksthe User_ID for such Devices which have a User_ID near them in the file. It assigns this Device to the appropriate User.7. We import the DID file. MOR checks the Device_ID/User_ID in the DIDs file and assigns a DID to this Device/User.8. We import the CLI file. If during import there is selected "Use Temporary Device ID " MOR checks the Device_ID in the CLIs file and assigns a CLI to this Device. If it is checked "Use Device ID" MOR checks the ID of Device in the CLIs file and assigns a CLI to this DeviceNOTE: in all processes, only a TEMPORARY User_ID/Device_ID is used. In the database, Users' ID/Devices' ID are not used directly. They have no relation to the User_ID/Device_ID from import files. SMS Addon Mass SMS Mass SMS addon lets you send one or more sms to an array ofnumbers automatically. This functionality can be used in telemarketing.Who can configure and use Mass SMS?Only end users can create Mass SMS campaigns, actions, edit, delete them and import numbers.Admin and reseller can check their users' campaigns and view actions, but cannot edit them.Configuration For user to be able to use Mass SMS, he first has to be subscribed to SMS Addon.Kolmisoft 2006-2013 42 After you prepare Providers go to ADDONS > SMS:You will reach list of subscribed to SMS service Users: Here have to subscribe User to SMS Service, just select user from dropdown and press Subscribe. If you want unsubscribe user from SMS Service clickicon. Click onicon to change Users LCR or Tariff for SMS Service. Reseller also has to have SMS Addon and SMS permission enabled.Kolmisoft 2006-2013 43 Usage From Admin/Reseller Go to ADDONS -> SMS -> Mass SMS.Here you can see the list of campaigns created by the end users. You can see the number of phone numbers imported, actions created, campaign status, profit from campaign and other information. Youcanalsocheckactionsbyclickingontheactioniconandsmsbeingsentbyselected campaign. From User Go to PERSONAL MENU -> SMS -> Mass SMS:The main window shows the user's campaigns. Here is more information and available settings that admin/reseller has: Kolmisoft 2006-2013 44 The user can Activate or Stop the Campaign by clicking theorbutton near the Campaign's status.A Campaign can only be Activated if it has free numbers AND some Actions.So please, before activating a Campaign, import some Numbers and create Actions.Campaigns Add campaign allows you to add a new campaign: The important fields here are:Start/Stop Times time when sms will be sent.Device each Campaign should be assigned to a Device in order for MOR to bill the call.CallerID - what CallerID to put on calls.NumbersClickonintheNumberscolumntochecknumberswhichwillbedialedoncampaign: The user can import phone numbers from a TXT file. Numbers should be in correct dialing format and not duplicated.Kolmisoft 2006-2013 45 Example of numbers file:442012345678 442087654321 442054987123 In a new Campaign there are no numbers, so click onImport numbers from file and select the file to upload: After uploading the file, you will see status of imported numbers: You can delete all numbers by clickingDelete all numbers. Also you can export details by clickingExport IVR/poll results to CSVIf a number is Completed, it is possible to reactivate it (tell the system to call it again) by clicking theicon near the number.Kolmisoft 2006-2013 46 ActionsClickin the Actions column to access the Campaign's actions: Here user can choose actions for the campaign. There is currently one type of action for Mass SMS:SEND SMS the specified sms will be sent to all numbers in the campaign.Resend all failed SMS You can resend all failed SMS ImprovementsQuick Stats upon request only (to avoid server overload) Important ChangesOnly User will be able to make calls. E.g. Admin, Accountant and Reseller will not be able to make calls anymore. They will have to create separate User to make calls.APIwillbeadjusted,methodnameschanged(keepingbackwards-compatibility), responses and parameters fixedMonitorings are converted into Alerts, old Monitorings window is removedKolmisoft 2006-2013 47 Introduction Kolmisoft VoIP Softswitch with Billing and Routing MOR is an advanced system that enables alternative telecoms to provide flexible voice services, effectively manage service offerings and grow their voice businesses due to the systems stability and high traffic scalability. Kolmisoft System MOR integrates the core AAA functions Authentication, Authorization, and Accounting withvitalfunctionsthatfacilitatetheeffectivemanagementofallbilling/routing-related processes: CustomersServicesFinanceServices distributionReportingTraffic partnersUser rights On the business side, Kolmisoft System MOR makes possible the deployment of services with high-qualityandflexibilitywithinanyVoIP businessmodel;onthe technicalsidethesystem maintainsseamlessperformanceathighandrapidlyincreasingtrafficvolume.Theoptimal combination of functions, the adaptability to every VoIP business model and rate-plan settings, as well as its stability, make Kolmisoft System MOR the absolute billing/routing and customer care solution for Voice Over Broadband/ IP businesses worldwide. Who is this product designed forKolmisoftSystemMORisdesignedforpremiumperformanceandscalability;therefore,itis suitable for VoIP or Broadband service providers who: plan for a full-scope VoIP business deploymentneed to maintain medium, high or very high voice traffic volumesdifferentiate on a first-class customer servicedemand high reliability from their billing systemenjoy rapid business development and have outgrown their legacy billing systems Kolmisoft 2006-2013 48 Supported Business ModelsKolmisoft System MOR is adaptable to telephony service providers' business models and custom requirements for service configuration. Voice-over-IP and Voice-over-Broadband providers can configure different service types within all of the following basic business models: Wholesale traffic origination/terminationRetailPrepaidPostpaidCalling CardsCorporate ClientsResidential ClientsInternet services How to make first call Thissmallguidewillshowhowtomakeyourfirstcallafter system installation.Create a tariff Tariffs are a set of rates (prices) to different destinations. Go to SETTINGS -> Billing -> Tariffs and clickNew tariff

Kolmisoft 2006-2013 49 Enter the name (you will use it to recognize tariff (price list) in variuos system places). Choose currency in which you will pay for providers/suppliers. Select what type of tariff do you want and click Create. In this example tariffs have rates/prices from your Providers. 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 However if you choose other type than Providers you will have to either import rates from CSV or fill them in manually by clickingRates ->New rate. The most important fields in Rates are Prefix and Rates. Create a provider Go to SETTINGS -> Billing -> Providers and clickNew provider

Select Technology, from a dropdown list assign Tarrif you have created, select the server and click Create.Kolmisoft 2006-2013 50 Provider configuration Right after creating a provider you will see this window:

Edit setting you need to edit and click Edit or leave it as it is configured. Kolmisoft 2006-2013 51 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 Go to SETTINGS -> Billing -> LCR and clickNew LCR

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. ClickProviders. Kolmisoft 2006-2013 52 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 To add a user go to SETTINGS -> Users. ClickAdd user.

Assign created LCR and click Create at the bottom of the page. Kolmisoft 2006-2013 53 Add a device for user To add a device go to SETTINGS -> Users and in the users list click the devices icon ( ). In the opened window clickAdd new device.

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 or IAX2 protocols. For the sake of simplicity, we will show how to configure Idefisk 1.37 , which is very small and easily configurable. First,downloaditfromourserver(http://www.kolmisoft.com/packets/idefisk137 _installer.exe) and install it. (It is for Windows OS.) Kolmisoft 2006-2013 54 ItcanbedownloadedforLinux(http://www.zoiper.com/zclinux.php)andforMacOS (http://www.zoiper.com/downloads/free/mac/communicator/ZoiperCommunicatorFree-1.04_installer.dmg). UseIdefiskconfigurationmanualtoconfigureIdefiskwithyourand username/password of test user's device. NOTE: that User 101 is by default Blocked to insure maximum security to your system. Unblock it before making a test call. 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 (http://www.kolmisoft.com/contacts) 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. Kolmisoft 2006-2013 55 Concepts/Definitions MOR Terminology 1. Accountant [http://wiki.kolmisoft.com/index.php/Accountant_permissions] a type of user whichhasmorerightsthansimpleuserinMOR,butstillnotenoughtofullymanageall configuration of MOR system. His rights can be adjusted at any time. 2.Actionlog[http://wiki.kolmisoft.com/index.php/Action_log]detailedreportaboutuser activity. 3. Addons [http://wiki.kolmisoft.com/index.php/MOR_Addons] a special feature group for MOR which adds additional functionality. 4. Admin [http://wiki.kolmisoft.com/index.php/Users] most powerful user account in MOR (just like root in UNIX systems). 5. Aggregate [http://wiki.kolmisoft.com/index.php/MOR_Manual#Reporting] advanced report on calls. 6. API [http://wiki.kolmisoft.com/index.php/MOR_API] - application programming interface is an interface implemented by a software program to enable interactionwith other software, similar to the way a user interface facilitates interaction between humans and computers. 7.Asterisk[http://en.wikipedia.org/wiki/Asterisk_(PBX)]-PBXfreesoftware,multiplatform, published under license GPL per Spencer Mark of the Digium company. 8. Auto Dialer [http://wiki.kolmisoft.com/index.php/Auto-Dialer_Addon] this addon allows to call an array of numbers automatically and when answered plays back a prerecorded message to the receiving end of the call. 9.Backup[http://wiki.kolmisoft.com/index.php/Backup_system]-abackuportheprocessof backingupreferstomakingcopiesofdatasothattheseadditionalcopiesmaybeusedto restore the original after a data loss event. 10. Browser title most top of web browser. 11. Callback [http://wiki.kolmisoft.com/index.php/Callback] in telecommunications, a callback (also written as call-back) occurs when the originator of a call is immediately called back in a second call as a response. 12. Call tracing [http://wiki.kolmisoft.com/index.php/Call_Tracing] used for checking the setup of MOR in order to be sure user will be able to dial out to specified destination number. 13. Calling cards [http://wiki.kolmisoft.com/index.php/Calling_Cards_Addon] an addon to MOR billingwhich adds Calling Card functionality.14. CDR call data (detail) records are computer records produced by a telephone exchange containing details of a call that passed through it. 15. Click2Call [http://wiki.kolmisoft.com/index.php/Click2Call] the technology which virtually always refers to a means for a web consumer to ask a website operator to call her.In Kolmisoft 2006-2013 56 other words, "clicktocall" would bemore accurately bereferred to as "RequestACall," as in "Please give me a call (here is my phone number)."16.Defaultdevice[http://wiki.kolmisoft.com/index.php/Default_device_settings]-whenyou configure default device's parameters, next time when you try make new device for someone, the newly device will have default device's parameters already. 17. Default user when you configure default user's parameters, next time when you try to make new user, he already will have them. 18. Destination destination helps identify country and city and destination number stands for final number which will be sent to provider. 19.Devices[http://wiki.kolmisoft.com/index.php/Devices]-representsendpointwhichcan generate (originate) or receive (terminate) calls. As example device can represent: VoIP phone, VoIP softphone, PSTN phone (connected through FXS port), PBX, softswitch, etc. 20. Dial Plan [http://wiki.kolmisoft.com/index.php/Dial_Plans] - a dial plan establishes rules how to handle some call. 21. DIDS [http://wiki.kolmisoft.com/index.php/MOR_Manual#DIDs] - Direct Inward Dialing is a feature offered by telephone companies for use with their customers'PBXsystems,whereby thetelephonecompanyallocatesarangeof numbers all connected to their customer's PBX. As calls are presented to the PBX, the number that the caller dialed is also given, so the PBX can route the call to the desired person or bureau within the organization. 22. Direct link or Direct URL [http://wiki.kolmisoft.com/index.php/What_is_direct_URL] a link to specified place in WEB. 23. Direction [http://wiki.kolmisoft.com/index.php/Directions_and_Destinations] - usually refers to Countries. Could also be satellite networks. They describe direction where the call will be routed. 24. Domain usually meaning of second level domain, for example: example.com (com is first level and example is second level) 25. Domestic meaning to describe calls inside country or in other words local calls. 26. FAX [http://wiki.kolmisoft.com/index.php/Fax2Email] - a fax (short for facsimile) is a document sent over a telephone line. FAX implementation in VOIP is very bad and currently it is still not possible to send/receive fax in VOIP at 100% succession rate. 27. Firewall is a part of a computer system or network that is designed to block unauthorized access while permitting authorized communications. Poorly configured firewall is very often the cause to failed calls. 28. Frontpage text first page in MOR GUI displayed for successfully logged in user or admin. 29. Graph function which generates visual data sets. 30. HGC [http://wiki.kolmisoft.com/index.php/Hangupcause_Codes] substitution for hangup cause code, those codes used to identify status of all made calls through MOR. 31. Integrity check [http://wiki.kolmisoft.com/index.php/Integrity_Check] a place with various properties of billing system which tells where potential problems could exists. 32. Invoice [http://wiki.kolmisoft.com/index.php/Invoices] - a document issued from a vendor for payment, detailing the goods or services the vendor has provided to the buyer, the cost(s), and any VAT due. The document may be called a 'Sales Invoice', from the point of view of the vendor, or a 'Purchase Invoice' by the buyer. Kolmisoft 2006-2013 57 33. IVR [http://wiki.kolmisoft.com/index.php/IVR_system] - Interactive Voice Response (IVR) is a technologythatallowsacomputertodetectvoiceanddualtonemulti-frequencysignaling (DTMF) keypad inputs. Most often usage of IVR in VOIP is for Virtual menus. 34. Last Calls [http://wiki.kolmisoft.com/index.php/Last_Calls] place in MOR GUI where you can see detailed list of last billed calls. 35. LCR [http://wiki.kolmisoft.com/index.php/LCR] stands for Least Cost Routing is the process of selecting the path of outbound communications traffic based on cost (cheapest price), order (always route calls to A, but if A fails, then route to B, if B fails, route to C etc.) or percent (used for load balancing, for example: send 50% of call to provider A and rest 50% to B). 36. Localization [http://wiki.kolmisoft.com/index.php/Localization] technology used by MOR which transforms received number to E.164 format number. 37. LOGO [http://wiki.kolmisoft.com/index.php/Logo_change] your company's logo. 38. MOR [http://www.kolmisoft.com/billing-and-routing/mor-voip-billing-features] softswitch with billing and routing made by Kolmisoft Ltd.39. Number digits - how many decimal digits will see all system users. You can change this setting in Settings. 40. Originate - initialize call. 41.PBX[http://en.wikipedia.org/wiki/Private_branch_exchange]-smallversionofthephone company's larger central switching office. A PBX is a private telephone switch. It is connected to groups of lines from one or more central offices and to all of the telephones at the location served by the PBX. 42.PhoneBook[http://wiki.kolmisoft.com/index.php/PhoneBook]placecontainingan alphabetical list of telephone numbers. 43. Prefix - refers to the first digits of a telephone number. These digits are a way to identify the area that the phone number is located in. 44. Profit [http://en.wikipedia.org/wiki/Profit_(accounting)] - amount expressed as a value that is left over from sales once all expenses have been deducted.45. Provider [http://wiki.kolmisoft.com/index.php/MOR_Manual#Providers] meaning for VOIP provider. Usually company sells voice traffic. 46. Rate [http://wiki.kolmisoft.com/index.php/Tariffs] a price for destination. 47.ReCAPTHA[http://www.google.com/recaptcha]amechanismwhichhelpstoprotect websites from automatic registrations. 48. Recording [http://wiki.kolmisoft.com/index.php/Recordings] voice file where you can hear conversation of your customer and remote end (where he called). 49. Registration [http://wiki.kolmisoft.com/index.php/Online_registration] place in MOR where new users could register themselves without help from MOR admin. 50. Rerating [http://wiki.kolmisoft.com/index.php/CDR_Rerating] recalculation of the call's price which is already recorded. 51.ResellerAddon[http://wiki.kolmisoft.com/index.php/Reseller_Addon]thisaddon incorporates basic reseller functionality support into MOR system which adds opportunity MOR system owner have reseller support. 52. Retail tariff [http://wiki.kolmisoft.com/index.php/Advanced_Rates] with retail tariff there is possibility get more control of how call will be billed, let say make first 15 seconds of call free. Kolmisoft 2006-2013 58 53. Router [http://en.wikipedia.org/wiki/Router] - a device that forwards data packets from one local area network (LAN) or wide area network (WAN) to another. Poorly configured device also leads to voice and traffic problems. 54. Service - product which can be sold to the client. That can be various types of services. For example: monthly fee, line rent, phone rent, internet plan. 55. Site your MOR website. 56.SMSAddon[http://wiki.kolmisoft.com/index.php/SMS_Addon]thisaddonaddsSMS sending option through