xurror / finscale-sms-service

Finscale SMS Service For Fineract CN and Finscale Sevice

Finsacale SMS Service

A lot has changed since last time, we upgraded the service in latest spring boot.

Docker deployment

docker-compose build

docker-compose up

Build set up

To create standalone application:

./gradlew clean build

To bootRun

./gradlew bootRun

As Jar

cd build/lib

java -jar message-gateway-0.0.1.jar

To create deployable war:

./gradlew clean build -Pprofile=deployable

war file can be found in build/libs

Kubernetes

##Steps to configure Message-Gateway

Create tenant with http://host:9191/tenants/

method: POST
Request Body:

{
	"tenantId" : "Tenant Id",
	"description" : "Some Description"
}

This API will return an unique tenant app key. This key should not be shared with others.

Create Twilio SMS Bridge with http://host:9191/smsbridges

method: POST
HEADERS:
	Fineract-Platform-TenantId:tenantId
	Fineract-Tenant-App-Key:generatedAppkeywhilecreatingtenant
Request Body:
{
	"phoneNo": "+xxxxxxxxxxx",
	"providerName": "Twilio Provider",
	"providerDescription": "SMS Provider for promotional messages",
	"providerKey":"Twilio",
	"countryCode":"+xx",
	"bridgeConfigurations": [
		{
			"configName":"Provider_Account_Id",
			"configValue":"xxxxx"
		},
		{
		"configName":"Provider_Auth_Token",
		"configValue":"xxxxx"
		}
	]
}

This API will return Bridge Identifier by which you can use while sending SMS

Create Infobip SMS Bridge with http://host:9191/smsbridges

method: POST
HEADERS:
	Fineract-Platform-TenantId:tenantId
	Fineract-Tenant-App-Key:generatedAppkeywhilecreatingtenant
Request Body:
{
	"phoneNo": "+xxxxxxxxxxx",
	"providerName": "Infobip Provider",
	"providerDescription": "SMS Provider for transactional messages",
	"providerKey":"InfoBip",
	"countryCode":"+xx",
	"bridgeConfigurations": [
		{
			"configName":"Provider_Account_Id",
			"configValue":"xxxxx"
		},
		{
		"configName":"Provider_Auth_Token",
		"configValue":"xxxxx"
		}
	]
}

This API will return Bridge Identifier by which you can use while sending SMS

Send SMS by using one of the provider with http://localhost:9191/sms

Method: POST
HEADERS:
	Fineract-Platform-TenantId:tenantId
	Fineract-Tenant-App-Key:generatedAppkeywhilecreatingtenant
Request Body:
	
	[{
		"internalId":"55",
		"mobileNumber":"xxxxxxxxxx",
		"message":"Hello from Fineract",
		"providerId":"2"
	}]

Note: While sending SMS, don't include country code as part of each message. This country code will be prefixed by taking value from provider details. You need configure host-address: [your public ip on which message-gateway is running] in application.yml

More services

We are adding

1. Adding Custom Service Provider
2. TextLocal
3. Plivo
4. PlaySMS