User avatar
johan
GpsGate
Posts: 14890
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

Plugin: Clickatel SMS

Fri Mar 05, 2010 9:51 pm

Note: for an updated version of this and other articles, we recommend you to check our knowledge base here

Clickatel SMS

This plugin can enable SMS for GpsGate Server by using Clickatel's SMS Gateway. More info about Clickatel here - http://www.clickatel.com

Follow these steps to install :
1. Login to SiteAdmin
2. Go to Plugins
3. Download and install Clicktel driver.

Make sure port 8008 is opened in your firewall.

Configure Clickatel Gateway account

1. Create a Clickatel account by http://www.clickatell.com/products/gateway.php
2. Login to your account.
3. Click on "Manage my Products".
4. Add a new connection of type "HTTP".

You now have one way SMS. You can send notifications from GpsGate Server to mobile phones.

If you want to use SMS for GPS device management and receive position reports over SMS from GPS devices you need "Two-Way Messaging". Follow those optional steps:

1. Order a MO number from Clickatel. It takes a couple of days for them to setup.
2. Go to "Manage my Products". Click on "Two-Way Messaging"
3. Click on "Edit" for your new MO Number.
4. Set "Reply Path" to "HTTP GET"
5. Set "Target Address" to
http://yourserver:8008/clickatel/

NOTE! If you specify a Route Label the incoming URL will change to:
http://yourserver:8008/clickatel/routelabel/

6. Click "Commit" to save.

You need to make sure your MO number is used as Sender ID for SMS sent from Clickatel Gateway to your devices. To do this you need to contact Clickatel support. But the process is ruffly like this:

7. Go to "My Settings"
8. Click on "Manage Sender IDs"
9. Click on "Add Sender ID"
10. Write in your MO Number and submit.
11. Write anything as verification in next step. And then contact Clickatel support to complete the process.

Configure GpsGate Server

1. Login to SiteAdmin
2. Go to "Settings -> SMS"
3. Select "ClickatelProvider" in drop down.
4. "Name", can be anything.
5. "Url" should be like this:

http://api.clickatell.com/http/sendmsg?api_id=1234&user=foo&password=xyz&from=4412345676

api_id - is the API ID you find in your Clickatel account.
user - is the username to your clickatel account.
password - is the password to your Clickatel account
from - is the MO number if you use two-way-sms

6. Click Save

Now SMS is enabled on your server!

Note! If you have a two-way solution you may need to add &mo=1 to the URL to get correct SenderID from Clickatel. It seems that is required in some parts of the world.

Troubleshooting
You can use the "Send Test SMS" feature under "Settings" in SiteAdmin.

All sent and received SMS can be monitored in the Terminal. You can also send SMS directly from the Terminal. More info:
http://forum.gpsgate.com/topic.asp?TOPIC_ID=10740

Check "ErrorLog" for errors. More info under "LogFile" plugin:
http://forum.gpsgate.com/topic.asp?TOPIC_ID=12886

Regards,
Johan

GpsGate Support

eastgear
Posts: 61
Joined: Thu Apr 02, 2009 8:08 pm

RE: Plugin: Clickatel SMS

Wed Apr 07, 2010 9:38 am

Hi,

For Configure GpsGate Server

1. Login to SiteAdmin
2. Go to "Settings"
3. Fill in all details for "SMS Proxy Settings". And "Enable SMS Proxy". Click Save.


What do i fill up for the below?

Proxy user login:
Proxy user password:
Retype password:
Proxy phone number:
Server Hostname:
Enable SMS Proxy:

For Clickatel account, i only have info on:

Login Name
Password

what do i fill in the
Proxy phone number:
Server Hostname:
Enable SMS Proxy:

Cheers,

Simon

User avatar
johan
GpsGate
Posts: 14890
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: Plugin: Clickatel SMS

Wed Apr 07, 2010 11:05 am

> What do i fill up for the below?

> Proxy user login:
Anything.

> Proxy user password:
Anything.

> Proxy phone number:
Your clickatel MO number.

> Server Hostname:
Your GpsGate Server public hostname.

> Enable SMS Proxy:
Check.

> For Clickatel account, i only have info on:

> Login Name
> Password
Use in URL as described above.

Regards,
Johan

Franson Support

eastgear
Posts: 61
Joined: Thu Apr 02, 2009 8:08 pm

RE: Plugin: Clickatel SMS

Wed Apr 07, 2010 11:27 am

I've manage to get it working, cheers.

guytracker
Posts: 197
Joined: Thu Apr 30, 2009 6:58 pm
Location: South Africa
Contact: Website

RE: Plugin: Clickatel SMS

Fri Jan 28, 2011 1:26 pm

I'm trying to get Clickatel to work. (FYI I'm using GGS v3 beta)
I've followed all instruction found on this thread and GGS accepted everything that I entered.
If I try a test SMS I get "an unexpected error" displayed.
Checking the log files (see below) I think that "User _SMSTEST has no _DeviceLogin privilege:" is the key.
What am I doing wrong?



2011-01-28 11:00:42.9387 | Info | 6 | DAOFactory.EndRoundTrip | Process time: 00:00:00 DB:1 _SYSTEM@TcpConnection |
2011-01-28 11:00:42.9387 | Info | 10 | CmdFactory.CreateGateCmd | Outgoing CmdExe created GpsGate._PlainText IN:_SYSTEM@TcpConnection OUT: Device:74 |
2011-01-28 11:00:42.9387 | Info | 10 | Queue.QueueItem | Queue 42: GpsGate._PlainText IN:_SYSTEM@TcpConnection OUT: Device:74 Unknown 0 |
2011-01-28 11:00:42.9543 | Info | 10 | SmsConnection.Start | Started SmsConnection = GpsGate.Online.Net.Sms.GpsGateSmsConnection |
2011-01-28 11:00:42.9699 | Info | 10 | NmeaConnection.DoLogin | User authenticated: _SMSTEST @ +27761731251 Auth: +27761731251 |
2011-01-28 11:00:42.9699 | Error | 10 | NmeaConnection.DoLogin | GpsGate.Online.AuthorizationException | User _SMSTEST has no _DeviceLogin privilege
2011-01-28 11:00:42.9699 | Error | 10 | Protocol.Send | GpsGate.Online.AuthorizationException | User _SMSTEST has no _DeviceLogin privilege
2011-01-28 11:00:42.9699 | Error | 10 | Queue.m_SendItem | Franson.Message.QueueFatalError | User _SMSTEST has no _DeviceLogin privilege
2011-01-28 11:00:42.9699 | Warn | 10 | Protocol.m_ExecuteCmd | Franson.Message.QueueFatalError | User _SMSTEST has no _DeviceLogin privilege
2011-01-28 11:00:42.9699 | Info | 10 | DAOFactory.EndRoundTrip | Process time: 00:00:00.0312000 DB:17 _SYSTEM@TcpConnection |
2011-01-28 11:00:43.0479 | Info | 10 | NmeaConnection.DoLogin | GpsGate.Online.DeviceNotFoundException | Device was not found for identifier = 135790246811220
2011-01-28 11:00:43.0479 | Info | 10 | DAOFactory.EndRoundTrip | Process time: 00:00:00 DB:1 GpsGate.NmeaPipe.SmartPipeTcpConnection |
2011-01-28 11:00:43.0479 | Info | 6 | TcpConnection.m_ReadCallback | Client closed connection GpsGate.NmeaPipe.SmartPipeTcpConnection |
2011-01-28 11:00:43.0479 | Info | 6 | NmeaConnection.Dispose | Disposing... GpsGate.NmeaPipe.SmartPipeTcpConnection 41.26.24.135:1057 |

User avatar
johan
GpsGate
Posts: 14890
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: Plugin: Clickatel SMS

Fri Jan 28, 2011 1:33 pm

OK, thanks for letting us know. I have reported this problem and we will fix it.

For now as a work around, please use the Terminal instead to send SMS. Register a user with a phone number on vehicle tracker, and you can then use the Terminal to send and receive SMS to a phone.

In fact the Terminal is a much better tool to verify any communication to and from the server.

Regards,
Johan

GpsGate Support

miro1
Posts: 45
Joined: Tue Sep 07, 2010 6:15 pm
Location: Slovenia
Contact: Website

RE: Plugin: Clickatel SMS

Sun Feb 20, 2011 6:26 pm

I have the same problem;

2011-02-20 14:01:01.4871 | Error | 11 | TcpConnection.m_ReadCallback | Franson.Message.QueueFatalError _SYSTEM@TcpConnection, x.x.x.x:49386 | User _SMSTEST has no _DeviceLogin privilege

Do you have solution for this issue?

User avatar
johan
GpsGate
Posts: 14890
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: Plugin: Clickatel SMS

Mon Feb 21, 2011 1:31 am

Use the Terminal for test sending SMS.

1. Add a phone number to a user in VehicleTracker.
2. Use the Terminal to send and receive SMS.

More info:
http://forum.gpsgate.com/topic.asp?TOPIC_ID=10740

Regards,
Johan

GpsGate Support

miro1
Posts: 45
Joined: Tue Sep 07, 2010 6:15 pm
Location: Slovenia
Contact: Website

RE: Plugin: Clickatel SMS

Mon Feb 21, 2011 1:44 am

I don't understand how can I send SMS alarms with Terminal instead GpsGate server itself?
Or this error occure only with SMS test?

edit: Only sending test message doesn't work. With Terminal it's work ok.

Is there a way to get report/plugin to calculate which user send SMS, how much and to which number?

hpi
Posts: 107
Joined: Tue Jan 18, 2011 1:50 pm

RE: Plugin: Clickatel SMS

Sun Mar 20, 2011 6:14 pm

Hi,

I'm having some issue using the ClickaTell plugin. I have enabled the SMS Proxy and get the following error when sending a Test SMS : "Error: Client was disconnected from the server."

When trying to send a SMS from the Terminal, I get the following error : "Unable to send message. (Error executing _SendRawData. No Message Queue (e.g. SMS Proxy) setup.)"

As a test, I used the clickatell URL to test if the clickatell service is working, it is.

Any help or suggestions will be welcomed.

User avatar
johan
GpsGate
Posts: 14890
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: Plugin: Clickatel SMS

Sun Mar 20, 2011 9:38 pm

I can see some steps was missing in the guide. The ClickatelProvider you add must be marked as "DefaultProvider", and you need to click "Start" to activate it. I have updated the guide again above, to look like this:

Configure GpsGate Server

1. Login to SiteAdmin
2. Go to "Settings"
3. Fill in all details for "SMS Proxy Settings". And "Enable SMS Proxy". Click Save.

4. Go to "Nmea Service -> Message Providers"
5. Select "ClickatelProvider" in drop down.
6. "Name", can be anything.
7. "Url" should be like this:

http://api.clickatell.com/http/sendmsg?api_id=1234&user=foo&password=xyz&from=4412345676

api_id - is the API ID you find in your Clickatel account.
user - is the username to your clickatel account.
password - is the password to your Clickatel account
from - is the MO number if you use two-way-sms

8. Check "DefaultProvider"
9. Click Save
10. Click "Start" for the the provider you just created.

Now SMS is enabled on your server!

Regards,
Johan

GpsGate Support

hpi
Posts: 107
Joined: Tue Jan 18, 2011 1:50 pm

RE: Plugin: Clickatel SMS

Sun Mar 20, 2011 11:17 pm

Hi Johan,

Great, the SMS service is now working!

The thing that I didn't do was to check the "DefaultProvider". After checking this, all is 100%.

Thank you

guytracker
Posts: 197
Joined: Thu Apr 30, 2009 6:58 pm
Location: South Africa
Contact: Website

RE: Plugin: Clickatel SMS

Tue Apr 12, 2011 12:55 pm

In order for this to work, I need to enter a (my) mobile number into the phone number field of one of the vehicles in the "tag". However, when I do this I get a "number already in use" message.
Indeed, the number is already in use on another application but so what?
I monitor a number of applications and I don't want to have to carry around a handful of mobile phones.

Why can't the required SMS number be simply entered when setting up the notification, instead of having to select a "tag"? (same with email addresses)

User avatar
johan
GpsGate
Posts: 14890
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: Plugin: Clickatel SMS

Tue Apr 12, 2011 2:02 pm

You can add one user to multiple applications. You do that under Applications in SiteAdmin. "Add existing user".

In GpsGate Server v3.0
1. Login to SiteAdmin
2. Click on "Applications"
3. Click on the application you want to add your use to.
4. Click on "Add Administrator"
5. Select "Add existing"
6. Search for your username
7. Select the user in the drop down and click "Add"
8. Scroll down the page and click "Save" to update the changes for the application.

Regards,
Johan

GpsGate Support

guytracker
Posts: 197
Joined: Thu Apr 30, 2009 6:58 pm
Location: South Africa
Contact: Website

RE: Plugin: Clickatel SMS

Tue Apr 12, 2011 3:20 pm

Thanks, that kinda helped. The problem is that if I do that, the vehicle that I'm registered with on the first application, now shows up on the second application.
I guess I'll have to "waste" a license to make myself an administrator without a vehicle.

My question is, why is it so complicated? Would it not be possible to change GGS so that any mobile number can be entered when setting up the alert? The same with emails on email alerts. Please just let us enter any email on any alert. This would make the system far more flexible.
That way alerts could be generated (for example) to the driver, the manager and even the CEO of the company if needed without them all having to be "users".
It would also mean that the system could be setup to so that certain emails/phone could receive alerts depending on the nature of the alert and depending on the scheduled time.

Return to “GpsGate Server - How to setup and use”