Difference between revisions of "Click2Call Specification"

From Kolmisoft Wiki
Jump to navigationJump to search
 
(14 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div align="center"><BIG><BIG><BIG><BIG>[[Image:warning.png|30px]]'''IMPORTANT - this add-on is no longer supported!'''</BIG></BIG></BIG></BIG></div>
<br>
Clic2Call module is dedicated to marketing companies which want to sell banners for click2call service.
==Concepts==
==Concepts==


Line 6: Line 12:
** [[C2C Addon Campaign| More details]]
** [[C2C Addon Campaign| More details]]
* User - Company - one separate organization which can have many Campaigns
* User - Company - one separate organization which can have many Campaigns


==System setup==
==System setup==


* Create User/Device (Company/Operator)
* Create User/Device (Company/Operator)
* Create Campaign
 
Create some Virtual device for the Company and forward it to your phone which should be used to serve the calls.
 
NOTE: you can use SIP/IAX2/etc devices if you want to use VoIP phone to serve calls.
 
* Allow this User to have Click2Call (C2C) Campaigns:
 
Go to '''SETTINGS - Addons - Click2Call''' and select user which should be allowed to have C2C Campaigns. Subscribe this user and he will be able to manage his C2C Campaigns in his login window.
 
* Create [[C2C Addon Campaign|Campaign]]
** Configure [[C2C Addon Comments| Comments]] for campaign
** Configure [[C2C Addon Comments| Comments]] for campaign
** Assign external number to Campaign to which calls should be routed


==Click2Call initiation==
==Click2Call initiation==
Line 20: Line 34:
** By this action he agrees that he will receive call from company which is advertising in this banner.
** By this action he agrees that he will receive call from company which is advertising in this banner.
* Banner send HTTP POST request to MOR server.
* Banner send HTTP POST request to MOR server.
** Example: http://<mor_ip>/billing/api?u=USERNAME&p=PASSWRORD&action=initiate_click2call&campaign_id=X&src=NUMBER
** [[MOR API c2c_callback|c2c_callback]] - Initiates Click2Call specific callback
** Where:
*** mor_ip - MOR server IP where to send request
*** USERNAME/PASSWORD - used to authenticate to system
*** action = initiate_click2call - tells what to do
*** campaign_id = X - to which campaign call should be placed
*** src = NUMBER - customer's number which should be dialed


==Call destination control==
==Call destination control==
Line 57: Line 65:
*** When company answers - user will be dialed
*** When company answers - user will be dialed
*** When (IF) user answers - calls will be bridged
*** When (IF) user answers - calls will be bridged
** Company can mark failed call as BAD if it fails to call several times (maybe number user entered is wrong)
* If user answers and company does not answer for some time (set separately) some prerecorded message is played for user (e.g. Sorry, but nobody is able to answer at this moment, you will be contacted later. Bye)


==Statistics==
==Statistics==
Line 71: Line 76:
* Call summary stats - how many calls in selected period, completed/failed user-company, etc +realtime
* Call summary stats - how many calls in selected period, completed/failed user-company, etc +realtime
* Diff. time interval comparison.
* Diff. time interval comparison.


==Invoices==
==Invoices==

Latest revision as of 11:12, 10 May 2019

Warning.pngIMPORTANT - this add-on is no longer supported!


Clic2Call module is dedicated to marketing companies which want to sell banners for click2call service.


Concepts

  • Client - interested person who enters his number in the banner
  • Device - Operator - person (worker in company) who answers calls
  • Campaign - virtual entity which describes one marketing campaign with several properties such as who have to answer the call, etc
  • User - Company - one separate organization which can have many Campaigns


System setup

  • Create User/Device (Company/Operator)

Create some Virtual device for the Company and forward it to your phone which should be used to serve the calls.

NOTE: you can use SIP/IAX2/etc devices if you want to use VoIP phone to serve calls.

  • Allow this User to have Click2Call (C2C) Campaigns:

Go to SETTINGS - Addons - Click2Call and select user which should be allowed to have C2C Campaigns. Subscribe this user and he will be able to manage his C2C Campaigns in his login window.

Click2Call initiation

  • On webpage user sees banner where he enters his phone number.
    • By this action he agrees that he will receive call from company which is advertising in this banner.
  • Banner send HTTP POST request to MOR server.

Call destination control

  • Destinations which can be dialed have rates in tariff which is assigned to users/companies.
  • Destinations without rates will not be dialed.
    • API will return error code that this destination is not supported.
Example: user enters number starting with 900…
We do not have rate for such call in our tariff so call will not be placed.


Call

  • System dials user first by default (if not set otherwise).
    • It is possible to choose where to call first: user or company.
  • When user pickups the phone:
    • System plays some prerecorded message to user (asking to wait, thanking for the calls, etc)
    • System dials to compamy
  • When company pickups - calls are bridged between user and company.


Failed call handling

  • If call can't be placed to user:
    • It can be redialed X times doing Y length pauses between redials
  • If call can't be placed to user X times call is visible in companie's GUI as FAILED call
    • Company can press on this call and callback will be initiated
      • First company will be dialed
      • When company answers - user will be dialed
      • When (IF) user answers - calls will be bridged

Statistics

  • Each company is able to see initiated calls with their status: COMPLETED/FAILED CALLING TO USER/FAILED CALLING TO COMPANY
  • Each call can have comment
    • Comment can have separate fields which can be set differently for each comment type
    • Call lists with comments can be exported to CSV
  • Call has field Direction which is based on user's number - tells from which country, city user is (or which mobile priovider)
  • Each Click2Call call consists of 2 separate real calls - to user and to company. Their stats are shown.
  • Call summary stats - how many calls in selected period, completed/failed user-company, etc +realtime
  • Diff. time interval comparison.

Invoices

  • Invoice to company is made on Click2Call basis. E.g. each COMPLETED click2call has X price.
  • Invoices can be exported to PDF.


Reminders

  • Company get's reminded by email if it is late to answer to some calls. Timeout is set separately for each campaign.