Africa's Talking SMS
Send and receive SMS from more than 300 million mobile subscribers across Africa.
This connector is available in the following products and regions:
| Service | Class | Regions |
|---|---|---|
| Logic Apps | Standard | All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD) |
| Power Automate | Premium | All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Power Apps | Premium | All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD) |
| Contact | |
|---|---|
| Name | Advice and answers from the Africa's Talking Team |
| URL | https://help.africastalking.com/en/ |
| smsussd@africastalking.com |
| Connector Metadata | |
|---|---|
| Publisher | Africa's Talking |
| Website | https://africastalking.com/sms |
| Privacy policy | https://africastalking.com/privacy_policy |
| Categories | Communication |
Africa's Talking SMS provides a powerful API that allows you to effectively send text communication to your customers when they need it. This connectors exposes a couple of operations that allow you to send SMS and retrieve messages in your inbox from our APIs.
Prerequisites
In order to use this connector, you will need the following:
- An account with Africa's Talking; you can sign up here.
- A live production application; you can create one after registering. After logging in, go ahead and create a new team, then create a new production ready application for that team. You will use this application's API key to create a new connection.
How to get credentials?
This connector uses API Key authentication. Once you've signed up and you've created a production ready application, click on this application to switch to its dashboard. Navigate to Settings > API Key to generate a new API Key for this application.
Known issues and limitations
This connector currently only works with production ready applications, so DO NOT use the default sandbox application's API key.
Creating a connection
The connector supports the following authentication types:
| Default | Parameters for creating connection. | All regions | Not shareable |
Default
Applicable: All regions
Parameters for creating connection.
This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.
| Name | Type | Description | Required |
|---|---|---|---|
| API Key | securestring | The API Key for this api | True |
Throttling Limits
| Name | Calls | Renewal Period |
|---|---|---|
| API calls per connection | 100 | 60 seconds |
Actions
| Fetch inbox |
Fetch messages in your inbox. |
| Send SMS |
Send an SMS to multiple numbers. |
Fetch inbox
Fetch messages in your inbox.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Username
|
username | True | string |
Your application's username, on Africa's Talking. |
|
Last received Id
|
lastReceivedId | integer |
An id of the last message you retrieved. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Messages
|
SMSMessageData.Messages | array of |
Messages |
Send SMS
Send an SMS to multiple numbers.
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Username
|
username | True | string |
Your application's username, on Africa's Talking. |
|
Message
|
message | True | string |
The message you'd like to send. |
|
phoneNumbers
|
phoneNumbers | True | array of string |
phoneNumbers |
|
Enqueue
|
enqueue | boolean |
Send as many messages as possible before waiting for acknowledgement from telcos. |
|
|
From
|
from | string |
Your registered short code or alphanumeric; defaults to AFRICASTKNG. |
Returns
| Name | Path | Type | Description |
|---|---|---|---|
|
Message
|
SMSMessageData.Message | string |
Message |
|
Recipients
|
SMSMessageData.Recipients | array of object |
Recipients |
|
cost
|
SMSMessageData.Recipients.cost | string |
cost |
|
messageId
|
SMSMessageData.Recipients.messageId | string |
messageId |
|
messageParts
|
SMSMessageData.Recipients.messageParts | integer |
messageParts |
|
number
|
SMSMessageData.Recipients.number | string |
number |
|
status
|
SMSMessageData.Recipients.status | string |
status |
|
statusCode
|
SMSMessageData.Recipients.statusCode | integer |
statusCode |
Triggers
| When a number opts out of receiving your bulk messages |
Triggered whenever a user opts out of receiving messages from your alphanumeric sender ID |
| When you receive a Delivery Report for a sent message |
Triggered when you receive a Delivery Report for a message initially sent |
| When you receive a message in your inbox |
Triggered whenever a message is sent to any of your registered shortcodes |
When a number opts out of receiving your bulk messages
Triggered whenever a user opts out of receiving messages from your alphanumeric sender ID
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Username
|
username | True | string |
Your Application's username |
Returns
- response
- object
When you receive a Delivery Report for a sent message
Triggered when you receive a Delivery Report for a message initially sent
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Username
|
username | True | string |
Your application's username. |
Returns
- response
- object
When you receive a message in your inbox
Triggered whenever a message is sent to any of your registered shortcodes
Parameters
| Name | Key | Required | Type | Description |
|---|---|---|---|---|
|
Username
|
username | True | string |
Your application's username |
Returns
- response
- object
Definitions
object
This is the type 'object'.