The Custom Connection feature can be used to connect to Africa's Talking for 2-way messaging. This feature is only available to admin users, and will require an existing Africa's Talking account's username, password and API key. In order to receive messages through Africa's talking, you will additionally have to either purchase a keyword to use their shared shortcode or a dedicated shortcode.
1. In the target workspace, logged in as a super admin, choose "create new connection" and select "custom" as the type
2. Set the following config for endpoint URL, HTTP Method, Content Type and Payload
| Africa's Talking | InfoBip | CLX | |
| Endpoint URL | http://api.africastalking.com/version1/messaging | https://{username:password}@api.infobip.com/sms/1/text/single | http://sms1.clxnetworks.net:3800/sendsms |
| HTTP Method | POST | POST | GET |
| Content Type | URLENC | JSON | URLENC |
| Payload | username=yourUsername, to=${destination}, message=${text},OPTIONAL-IF-SHORTCODE from=12345 |
{ |
username=USERNAME, password=PASSWORD, from=60163, to=${destination}, text=${text} |
| Mark message as sent | ${responseCode >= 200 && responseCode < 300 && responseCode != 203} | ${responseCode >= 200 && responseCode < 300} | ${responseCode >= 200 && responseCode < 300} |
| Notes |
Add the ApiKey to the header. replace "yourUsername" and "theApiKey" with the username of the Africa's Talking account, and the API key: https://account.africastalking.com/settings/apikey
|
3. Set the following config for "Receiving Settings"
| Africa's Talking | InfoBip | CLX | |
| Where to paste URL | https://account.africastalking.com/sms/inboxcallback |
http://dev.infobip.com/docs/push-received-messages has help Contact <Niki.Shahnavaz@infobip.com> who is briefed. Can direct our user/clients to her also. |
https://frontlinesms.jira.com/browse/TOOLS-1555 |
| URL to paste | https://cloud.frontlinesms.com/api/1/customFconnection/YOUR-ID |
https://cloud.frontlinesms.com/api/1/customFconnection/YOUR-ID?from=%2B%sender%&message=%text% |
|
| Message Parameter | ${params.text} | ${params.message} | msg |
| Destination Number Parameter | ${params.from} | ${"+" + params.from} | originator |
4. Save the CustomFConnection. You should now be able to send outbound messages
5. To enable message receiving, copy the URL below the custom connection in the Frontline connection list, and enter it as the callback URL in Africa's talking
The Africa's Talking callback url config is at https://account.africastalking.com/sms/inboxcallback
0 Comments