Generic SMS Gateway Functionality

Support - Assistance technique
#1

Hi all,

Got 2 questions:

  1. I have been working on SMS reporting to DHIS2 through the generic HTTP gateway and I have hit a snag. I think I am doing something wrong. Been following the following guide: https://docs.dhis2.org/master/en/user/html/mobile_sms_service.html#gateway.configuration, with the following screenshot:

image
generichttp-configuration.png949×550 37.8 KB

image
log.png1353×80 28 KB

···

Unfortunately, all the outbound SMS fail. Not much info from logs:

​The URL template section (from documentation) is not very clear on the format. I currently have it as http://mycustomsmsgateway.url/send I have also tried with parameters http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber} as outlined in DHIS 2 Core Source Code, still nothing. No GET/POST request is detected at gateway endpoint.

  1. How to you get inbound sms into DHIS2? (From Generic HTTP Gateway into DHIS). If this functionality has not been implemented yet, is there a work around, like directly populating a table in the database or sending a GET/POST request to a particular port/socket

Any insights will help. Thanks.

Regards,
Ejimba Eric

#2

Dear Eric,

There are two things to note. The SMS Gateway that you set in DHIS2 is for any outbound text messaging. The URL Template should be based on your SMS service provider’s template. This will allow you to forward SMS messages from DHIS2 to the SMS service provider that will handle the delivery of the messages.

URL TEMPLATE IS FROM the SMS Provider

On the other hands, you should also configure a URL from the SMS service providers to forward ALL messages probably using a keyword to a DHIS2 instance. The latest version of DHIS2 2.28 has recently changed its SMS API that will receive and process SMSes as below.

[http://DHIS2_DOMAIN_URL/api/sms/inbound?message=[TEXT MESSAGE]&originator=PHONE NUMBER]

If you need an SMS service provider, I can help set up for you BUT you will be required to pay for the SMSes. [We can discuss more]

Regards

image
log.png1353×80 28 KB

image
generichttp-configuration.png949×550 37.8 KB

···

On Thu, Nov 16, 2017 at 2:47 PM, Eric Ejimba ejimba@gmail.com wrote:

Hi all,

Got 2 questions:

  1. I have been working on SMS reporting to DHIS2 through the generic HTTP gateway and I have hit a snag. I think I am doing something wrong. Been following the following guide: https://docs.dhis2.org/master/en/user/html/mobile_sms_service.html#gateway.configuration, with the following screenshot:

Unfortunately, all the outbound SMS fail. Not much info from logs:

​The URL template section (from documentation) is not very clear on the format. I currently have it as http://mycustomsmsgateway.url/send I have also tried with parameters http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber} as outlined in DHIS 2 Core Source Code, still nothing. No GET/POST request is detected at gateway endpoint.

  1. How to you get inbound sms into DHIS2? (From Generic HTTP Gateway into DHIS). If this functionality has not been implemented yet, is there a work around, like directly populating a table in the database or sending a GET/POST request to a particular port/socket

Any insights will help. Thanks.

Regards,
Ejimba Eric

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

–

You can do anything, but not everything.

#3

Additionally, you now do not need to paste the whole URL template as is.

You will need to break down the parameters of the template. i.e.

http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber}

Message Parameter = message

Recipient Parameter = phoneNumber

URL Template = http://mycustomsmsgateway.url/send

PLEASE NOTE THAT THE FULL TEMPLATE SHOULD BE PROVIDED BY THE SMS PROVIDER.

The Parameter names might vary.

Regards

image
generichttp-configuration.png949×550 37.8 KB

image
log.png1353×80 28 KB

···

On Thu, Nov 16, 2017 at 4:56 PM, Ocaya Stephen stephocay@gmail.com wrote:

Dear Eric,

There are two things to note. The SMS Gateway that you set in DHIS2 is for any outbound text messaging. The URL Template should be based on your SMS service provider’s template. This will allow you to forward SMS messages from DHIS2 to the SMS service provider that will handle the delivery of the messages.

URL TEMPLATE IS FROM the SMS Provider

On the other hands, you should also configure a URL from the SMS service providers to forward ALL messages probably using a keyword to a DHIS2 instance. The latest version of DHIS2 2.28 has recently changed its SMS API that will receive and process SMSes as below.

[http://DHIS2_DOMAIN_URL/api/sms/inbound?message=[TEXT MESSAGE]&originator=PHONE NUMBER]

If you need an SMS service provider, I can help set up for you BUT you will be required to pay for the SMSes. [We can discuss more]

Regards

–

On Thu, Nov 16, 2017 at 2:47 PM, Eric Ejimba ejimba@gmail.com wrote:

Hi all,

Got 2 questions:

  1. I have been working on SMS reporting to DHIS2 through the generic HTTP gateway and I have hit a snag. I think I am doing something wrong. Been following the following guide: https://docs.dhis2.org/master/en/user/html/mobile_sms_service.html#gateway.configuration, with the following screenshot:

Unfortunately, all the outbound SMS fail. Not much info from logs:

​The URL template section (from documentation) is not very clear on the format. I currently have it as http://mycustomsmsgateway.url/send I have also tried with parameters http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber} as outlined in DHIS 2 Core Source Code, still nothing. No GET/POST request is detected at gateway endpoint.

  1. How to you get inbound sms into DHIS2? (From Generic HTTP Gateway into DHIS). If this functionality has not been implemented yet, is there a work around, like directly populating a table in the database or sending a GET/POST request to a particular port/socket

Any insights will help. Thanks.

Regards,
Ejimba Eric

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

You can do anything, but not everything.

–

You can do anything, but not everything.

#4

Dear Stephen,

It is working…Thanks for all the help. I have been able to do it on the test server and will be cascading the same to production server.

Please note that we are currently testing this feature with http://www.kannel.org/ SMS gateway with a USB modem. We will be moving to an SMS Provider once the implementation is sustainable. Will consult you on that.

Thank you very much. I really appreciate it

image
generichttp-configuration.png949×550 37.8 KB

image
log.png1353×80 28 KB

···

On Thu, Nov 16, 2017 at 5:06 PM, Ocaya Stephen stephocay@gmail.com wrote:

Additionally, you now do not need to paste the whole URL template as is.

You will need to break down the parameters of the template. i.e.

http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber}

Message Parameter = message

Recipient Parameter = phoneNumber

URL Template = http://mycustomsmsgateway.url/send

PLEASE NOTE THAT THE FULL TEMPLATE SHOULD BE PROVIDED BY THE SMS PROVIDER.

The Parameter names might vary.

Regards

Regards,
Ejimba Eric

On Thu, Nov 16, 2017 at 4:56 PM, Ocaya Stephen stephocay@gmail.com wrote:

Dear Eric,

There are two things to note. The SMS Gateway that you set in DHIS2 is for any outbound text messaging. The URL Template should be based on your SMS service provider’s template. This will allow you to forward SMS messages from DHIS2 to the SMS service provider that will handle the delivery of the messages.

URL TEMPLATE IS FROM the SMS Provider

On the other hands, you should also configure a URL from the SMS service providers to forward ALL messages probably using a keyword to a DHIS2 instance. The latest version of DHIS2 2.28 has recently changed its SMS API that will receive and process SMSes as below.

[http://DHIS2_DOMAIN_URL/api/sms/inbound?message=[TEXT MESSAGE]&originator=PHONE NUMBER]

If you need an SMS service provider, I can help set up for you BUT you will be required to pay for the SMSes. [We can discuss more]

Regards

–

You can do anything, but not everything.

On Thu, Nov 16, 2017 at 2:47 PM, Eric Ejimba ejimba@gmail.com wrote:

Hi all,

Got 2 questions:

  1. I have been working on SMS reporting to DHIS2 through the generic HTTP gateway and I have hit a snag. I think I am doing something wrong. Been following the following guide: https://docs.dhis2.org/master/en/user/html/mobile_sms_service.html#gateway.configuration, with the following screenshot:

Unfortunately, all the outbound SMS fail. Not much info from logs:

​The URL template section (from documentation) is not very clear on the format. I currently have it as http://mycustomsmsgateway.url/send I have also tried with parameters http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber} as outlined in DHIS 2 Core Source Code, still nothing. No GET/POST request is detected at gateway endpoint.

  1. How to you get inbound sms into DHIS2? (From Generic HTTP Gateway into DHIS). If this functionality has not been implemented yet, is there a work around, like directly populating a table in the database or sending a GET/POST request to a particular port/socket

Any insights will help. Thanks.

Regards,
Ejimba Eric

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

You can do anything, but not everything.

–

#5

Eric, I am happy that this has resolved your issues.

Regards

image
log.png1353×80 28 KB

image
generichttp-configuration.png949×550 37.8 KB

···

On Thu, Nov 16, 2017 at 5:24 PM, Eric Ejimba ejimba@gmail.com wrote:

Dear Stephen,

It is working…Thanks for all the help. I have been able to do it on the test server and will be cascading the same to production server.

Please note that we are currently testing this feature with http://www.kannel.org/ SMS gateway with a USB modem. We will be moving to an SMS Provider once the implementation is sustainable. Will consult you on that.

Thank you very much. I really appreciate it

–

Regards,
Ejimba Eric

On Thu, Nov 16, 2017 at 5:06 PM, Ocaya Stephen stephocay@gmail.com wrote:

Additionally, you now do not need to paste the whole URL template as is.

You will need to break down the parameters of the template. i.e.

http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber}

Message Parameter = message

Recipient Parameter = phoneNumber

URL Template = http://mycustomsmsgateway.url/send

PLEASE NOTE THAT THE FULL TEMPLATE SHOULD BE PROVIDED BY THE SMS PROVIDER.

The Parameter names might vary.

Regards

On Thu, Nov 16, 2017 at 4:56 PM, Ocaya Stephen stephocay@gmail.com wrote:

Dear Eric,

There are two things to note. The SMS Gateway that you set in DHIS2 is for any outbound text messaging. The URL Template should be based on your SMS service provider’s template. This will allow you to forward SMS messages from DHIS2 to the SMS service provider that will handle the delivery of the messages.

URL TEMPLATE IS FROM the SMS Provider

On the other hands, you should also configure a URL from the SMS service providers to forward ALL messages probably using a keyword to a DHIS2 instance. The latest version of DHIS2 2.28 has recently changed its SMS API that will receive and process SMSes as below.

[http://DHIS2_DOMAIN_URL/api/sms/inbound?message=[TEXT MESSAGE]&originator=PHONE NUMBER]

If you need an SMS service provider, I can help set up for you BUT you will be required to pay for the SMSes. [We can discuss more]

Regards

–

You can do anything, but not everything.

On Thu, Nov 16, 2017 at 2:47 PM, Eric Ejimba ejimba@gmail.com wrote:

Hi all,

Got 2 questions:

  1. I have been working on SMS reporting to DHIS2 through the generic HTTP gateway and I have hit a snag. I think I am doing something wrong. Been following the following guide: https://docs.dhis2.org/master/en/user/html/mobile_sms_service.html#gateway.configuration, with the following screenshot:

Unfortunately, all the outbound SMS fail. Not much info from logs:

​The URL template section (from documentation) is not very clear on the format. I currently have it as http://mycustomsmsgateway.url/send I have also tried with parameters http://mycustomsmsgateway.url/send?message={message}&phoneNumber={phoneNumber} as outlined in DHIS 2 Core Source Code, still nothing. No GET/POST request is detected at gateway endpoint.

  1. How to you get inbound sms into DHIS2? (From Generic HTTP Gateway into DHIS). If this functionality has not been implemented yet, is there a work around, like directly populating a table in the database or sending a GET/POST request to a particular port/socket

Any insights will help. Thanks.

Regards,
Ejimba Eric

Mailing list: https://launchpad.net/~dhis2-users

Post to : dhis2-users@lists.launchpad.net

Unsubscribe : https://launchpad.net/~dhis2-users

More help : https://help.launchpad.net/ListHelp

You can do anything, but not everything.

–

You can do anything, but not everything.