Difference between revisions of "MOR integration"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(23 intermediate revisions by 2 users not shown)
Line 17: Line 17:
[http://wiki.kolmisoft.com/index.php/MOR_Installation MOR installation]
[http://wiki.kolmisoft.com/index.php/MOR_Installation MOR installation]


It will be a fully functioning MOR system with a 2 calls limit.


<br><br>
<br><br>
==[[MOR_API|MOR API]]==
==[[MOR_API|MOR API]]==
===Reasons to use MOR API===
===Reasons to use MOR API===
Line 68: Line 68:


==Useful tools==
==Useful tools==
* When your changes are overwritten by MOR upgrade scripts - you can restore them easier with merge tools like: [http://winmerge.org/ Winmerge] which shows you the differences between files and allows you to merge as you go.
When your changes are overwritten by MOR upgrade scripts - you can restore them easier with merge tools like: [http://winmerge.org/ Winmerge] which shows you the differences between files and allows you to merge as you go.
<br><br>
<br><br>


== Custom features development ==
== Recommended developers ==
Your custom developed MOR features can be integrated into main code base.
 
If you don't have your own programming resources, you can [https://www.kolmisoft.com/company/contact contact us] and we'll introduce you to a partner who has done many integrations before.


Please [[Custom development requirements|check here for requirements]] in order the features would be integrated.
<br><br>
<br><br>


== The best way to integrate MOR with a custom designed website ==
The best choice is to use [[MOR_API | the API]].


== Recommended developers ==
Using it you can do any changes and modifications as if you were using the management portal (GUI) of MOR.
 
However, not all the settings which can be found in MOR GUI are possible over API.
 
For that, you can use the direct access to the database over the PhpMyAdmin.


We recommend to find a developer that will help you with integrations in https://www.odesk.com/ which is world's largest online workplace where companies hire freelancers to get the job done.
The password to access to the database over the PhpMyAdmin can be found in [[How_to_access_MySQL_database_via_WEB | this manual]].


Here's a feedback from one of our clients who has successfully used freelancer from Odesk to do integrations with MOR:
The direct link for a web browser is: http://YOUR IP ADDRESS/mordbadmin (e.g. http://1.1.1.1/mordbadmin)


Regarding Odesk programmers, I do have a few that I use but the main one I use from Ukraine is full time on my projects now.  It really depends on what skills you're looking for too.
To join the database you may use the mor/mor or root user.


My suggestion is to post a project on Odesk and I can help you look through the candidates. In general, you're looking for people who have at least 100 hours, reasonable rate, Eastern European (or Pakistan if you want cheap), not too many open projects (or they're too busy), good feedback etc.
'''IMPORTANT!''' Any changes that are done directly in the database may ruin the system and are not supported by Kolmisoft. So make sure you consult with professionals before making any changes.


However it's not until you really start going back and forth with them on Skype can you tell if it's a good match.


<br><br>
== Sample Website integration with MOR #1==


Here you can see screenshots from a sample website integration, done by Marshall Taplits (company - Spaxtel):
<br><br>
'''Home Screen'''. Shows all possibilities of a web portal.
<br><br>
[[File:Spaxtel_1.png]]
<br><br>
'''Rates'''. Allows you to check your rates online.
<br><br>
[[File:Spaxtel_2.png]]
<br><br>
'''Account'''. Allows you to edit details of your account.
<br><br>
[[File:Spaxtel_3.png]]
<br><br>
'''Make a call'''. Allows you to initiate a callback directly from the web portal.
<br><br>
[[File:Spaxtel_4.png]]
<br><br>
'''Recharge'''. Allows you to top-up your balance using credit card, Paypal, Bitcoin or other online payment method.
<br><br>
[[File:Spaxtel_5.png]]
<br><br>
'''Call history'''. Allows you to review your recent calls
<br><br>
[[File:Spaxtel_6.png]]
<br><br>
== Sample Website integration with MOR #2==
Here you can see screenshots from another sample website integration:
<br><br>
'''Login page'''
<br><br>
[[File:MOR_Integration_0.png]]
<br><br>
'''Start page''' is shown once you log in.
<br><br>
[[File:MOR_Integration_1.png]]
<br><br>
'''Rates'''. Allows you to check your rates online.
<br><br>
[[File:MOR_Integration_2.png]]
<br><br>
'''Last Calls'''. Allows you to review your recent calls.
<br><br>
[[File:MOR_Integration_3.png]]
<br><br>
'''Callback'''. Allows you to initiate a callback directly from the web portal.
<br><br>
[[File:MOR_Integration_4.png]]
<br><br>
'''Campaigns'''. Allows you to create an Auto-dialler campaign.
<br><br>
[[File:MOR_Integration_5.png]]
<br><br>
'''Quick Forwards'''. Allows you to use the [[Quick_Forwards | Quick Forwards]] option.
<br><br>
[[File:MOR_Integration_6.png]]
<br><br>
'''Statistics'''. Allows you to review the statistics of your calls.
<br><br>
[[File:MOR_Integration_7.png]]
<br><br>
'''Missed calls'''. Allows you to review the calls that you missed.
<br><br>
[[File:MOR_Integration_8.png]]
<br><br>
<br><br>


Latest revision as of 07:50, 8 November 2023

About

This page is dedicated for programmers who are integrating MOR into other products or modifying MOR GUI.



Facts about MOR

Technologies used

  • Ruby on Rails - GUI
  • MySQL - used for data storage
  • Asterisk - used for interconnecting the calls.
  • CentOS Linux - platform. Other Linux distributions might work but are not supported by Kolmisoft.
  • Apache - a web server



MOR Development Machine

We advise you to create a development machine where you could test your changes. A development machine can be prepared by following this guide:

MOR installation




MOR API

Reasons to use MOR API

  • MOR API allows you to perform some operations without modifying the GUI - does not require any Ruby on Rails knowledge.
  • MOR API can be used in any programming language which supports sending POST requests.
  • When you modify a GUI directly - each time MOR system is updated - your changes are overwritten by MOR upgrade scripts. Your changes are backuped and it is your responsibility to merge those changes back.



MOR users that are allowed to use MOR API

  • Admin
  • Reseller
  • Accountant



Operations supported by MOR API


And many more...

A full MOR API documentation is available here.

Sending a POST request in various programming languages to MOR

Remember, you have to send your requests to MOR's URL. No libraries provided by Kolmisoft are needed to send POST requests to MOR. Every programming language provides it's own libraries for this task.



Facts/commands you should know

  • MOR GUI is located in /home/mor and can be accessed using a SSH supporting client like Filezilla
  • When you modify a ruby code - you have to restart the web server for the changes to take effect:
/etc/init.d/httpd restart

[root@localhost ~]# cat /root/phpMyAdminPassword
Login and Password from phpMyAdmin system: admin t5Hg1PR1yu
  • Changes in /home/mor/public are not overwritten during updates - that allows you to change default MOR images and CSS.
  • Using this command you can determine a current MOR version and revision:
svn info /home/mor



Useful tools

When your changes are overwritten by MOR upgrade scripts - you can restore them easier with merge tools like: Winmerge which shows you the differences between files and allows you to merge as you go.

Recommended developers

If you don't have your own programming resources, you can contact us and we'll introduce you to a partner who has done many integrations before.



The best way to integrate MOR with a custom designed website

The best choice is to use the API.

Using it you can do any changes and modifications as if you were using the management portal (GUI) of MOR.

However, not all the settings which can be found in MOR GUI are possible over API.

For that, you can use the direct access to the database over the PhpMyAdmin.

The password to access to the database over the PhpMyAdmin can be found in this manual.

The direct link for a web browser is: http://YOUR IP ADDRESS/mordbadmin (e.g. http://1.1.1.1/mordbadmin)

To join the database you may use the mor/mor or root user.

IMPORTANT! Any changes that are done directly in the database may ruin the system and are not supported by Kolmisoft. So make sure you consult with professionals before making any changes.




Sample Website integration with MOR #1

Here you can see screenshots from a sample website integration, done by Marshall Taplits (company - Spaxtel):

Home Screen. Shows all possibilities of a web portal.

Spaxtel 1.png

Rates. Allows you to check your rates online.

Spaxtel 2.png

Account. Allows you to edit details of your account.

Spaxtel 3.png

Make a call. Allows you to initiate a callback directly from the web portal.

Spaxtel 4.png

Recharge. Allows you to top-up your balance using credit card, Paypal, Bitcoin or other online payment method.

Spaxtel 5.png

Call history. Allows you to review your recent calls

Spaxtel 6.png

Sample Website integration with MOR #2

Here you can see screenshots from another sample website integration:

Login page

MOR Integration 0.png

Start page is shown once you log in.

MOR Integration 1.png

Rates. Allows you to check your rates online.

MOR Integration 2.png

Last Calls. Allows you to review your recent calls.

MOR Integration 3.png

Callback. Allows you to initiate a callback directly from the web portal.

MOR Integration 4.png

Campaigns. Allows you to create an Auto-dialler campaign.

MOR Integration 5.png

Quick Forwards. Allows you to use the Quick Forwards option.

MOR Integration 6.png

Statistics. Allows you to review the statistics of your calls.

MOR Integration 7.png

Missed calls. Allows you to review the calls that you missed.

MOR Integration 8.png

Other information sources about MOR



Retrieved from "https://wiki.kolmisoft.com/index.php?title=MOR_integration&oldid=29173"