wiki:UserGuidelines/Messaging

Version 13 (modified by Fran Boon, 11 years ago) ( diff )

--

Messaging Module

This is the userguide for the current version of the Messaging module

NB The Cron task(s) needs to be enabled in cron/crontab. THis doesn't currently work for Win32 service. For mod_wsgi, need to add support to the system crontab.

Email

How do I use Gmail to send outbound mail?

Edit models/000_config.py Uncomment these lines & put in the username/password that you wish to use:

#deployment_settings.mail.server = "smtp.gmail.com:587"
#deployment_settings.mail.login = "username:password"

SMS

What Hardware do I need?

If using an online gateway, then you don't need any hardware other than the network card :)

If you wish to be able to send messages without an Internet connection then you need a comaptible device such as one from the following.

Hardware compatibility databases:

How do I use it?

1st you need to decide whether you will be using a local modem or an online gateway (e.g. Clickatell or Tropo).

This is configured by the Administrator in the Global message Settings.

The Gateway or Modem details are configured via their own panels.

Clickatell

Global provider - average price globally:

  • http://clickatell.com
    https://api.clickatell.com/http/sendmsg
    user=myusername&password=mypassword&api_id=myapi_id
    text
    to
    

Mvaayoo

Indian provider - cheap for local calls

http://api.mvaayoo.com/mvaayooapi/MessageCompose
user=my@email.address:mypassword&senderID=TEST SMS&state=4
msgtxt
receipientno

Tropo

Provide an IVR-style service which supports XMPP (GTalk) & Twitter as well as SMS.

  • http://tropo.im
  • The Twitter/GTalk 'bots' are great for testing the system out without incurring call charges

US Inbound number is free for development use (not many other local numbers available) so this is great for prototyping.

They have helpful support forums.

Set the 'Global Messaging Settings' to use Tropo:

Configure your Tropo token into:

Inbound messages are collected in controllers/msg.py

Parsing is done via the parserdooth() function.

How does it work?

Compose a new message. The autocomplete will find either Persons or Groups.

Contact numbers from Persons have non-numeric characters stripped & then a '+' is prefixed when using a local modem.

For gateway usage, a default Country Code is added to numbers which start with 0.

More


UserGuidelines

Note: See TracWiki for help on using the wiki.