Callback over Email

From Kolmisoft Wiki
Jump to navigationJump to search

Description

This function receives email and initiates callback using details in this email.

A device can have one CallerID from which it is able to initiate Callback.

Admin sets up the email box, which should be monitored for callback execution.

An SMS to initiate callback can look like:

For CallerID change: change*new_callerid

For callback inititation:

  • first_number#second_number
  • first_number - will ask destination

Then SMS gateway should send email to MOR to initiate callback in following format:

CallerID change:

  • Email subject: change
  • Email body: old callerid\nnew callerid, (\n) means new line

Callback inititation:

  • Email subject: callback
  • Email body:
MOR_PARAM1 auth_callerid
MOR_PARAM2 first_number
MOR_PARAM3 second_number


NOTE: email format should be plain, not html!



Inner mechanics

1. SMS gateway sends email to specified address (example callback@hostname.com) in the following format:

CallerID change:

  • Email subject: change
  • Email body: old callerid\nnew callerid, (\n) means new line

Callback inititation:

  • Email subject: callback
  • Email body:
MOR_PARAM1 auth_callerid
MOR_PARAM2 first_number
MOR_PARAM3 second_number


2. Postfix server gets email and sends to /usr/local/mor/mor_email2callback.sh script

This is configured in /etc/aliases file:

callback: "|/usr/local/mor/mor_email2callback.sh"


3. /usr/local/mor/mor_email2callback.sh script parses email and sends everything to MOR.

wget -o /dev/null -O /dev/null "http://localhost/billing/emails/email_callback?subject=$subject&param1=$param1&param2=$param2&param3=$param3"

4. MOR GUI initiates callback using AMI command Originate.




See also