# 3.4.7 Africa's Talking

This section allows you to configure Africa's Talking as a data source and receive SMS messages as unstructured posts in your Ushahidi deployment.

<details>

<summary>Prerequisite Information: Username, SMS Short Code, and API Key</summary>

1. Login to Africas Talking dashboard
2. Click on **App name**

<img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2F9aIFDR5FTxFfOxLPAtRY%2FPRE-1-TeamDashboard.png?alt=media&#x26;token=b3e1bd8d-de9f-4ccf-93aa-dd74adde813d" alt="" data-size="original">

Take note of *Username*

<img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FxBAWWWXjnj8CVgi9HE5x%2FPRE-2-AppDashboard.png?alt=media&#x26;token=4b4a7929-798c-4cd3-82b5-db00d63de88c" alt="" data-size="original">

3. Click on **SMS** -> **Short Codes** -> **My Shortcodes**

<img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FQ58pCo1hvhYfVJHio34B%2FPRE-3-SMSShortCodes.png?alt=media&#x26;token=c7ce2d7e-5a35-4512-afb1-dc3beb83d9f7" alt="" data-size="original">

Take note of *Short Code*

4. Click on **Settings** -> **API Key**
5. Enter account password and click **Generate**

<img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2Fx7B7b26iqk5IeX4rgEBk%2FPRE-4-GenerateAPIKey.png?alt=media&#x26;token=6b2d9587-9d2d-4efd-a60e-7a4f64fec067" alt="" data-size="original">

Take note of *API Key* (will also be automatically copied into your clipboard)

</details>

### Setup Africa's Talking Data Source in Ushahidi

1. Login to Ushahidi.

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FQU6tZkQhOCmLTVDKKChp%2FUshahidiLoggedIn.png?alt=media&#x26;token=a2419aeb-0c9e-4428-baf6-056ba958a582" alt=""><figcaption></figcaption></figure>

2. Click on **Settings** -> **Data Sources**
3. Click **Add source**

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FXm7n4nGlCm2MlkRvUSP4%2F2-DataSources.png?alt=media&#x26;token=98123ae2-b55b-4830-a46a-debc84526e19" alt=""><figcaption></figcaption></figure>

4. Select **Africa's Talking**

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FaVu6utO5WIFzFLsWbbcB%2F3-ChooseDataSource.png?alt=media&#x26;token=dc5b3861-aa55-4255-ae85-c282d58076d3" alt=""><figcaption></figcaption></figure>

5. Enter your *Username, API Key,* and *SMS Short Code,* and then click **Save.**

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FgYGVKDeJkO58ZQ6CRpoS%2F4-AddDataSource.png?alt=media&#x26;token=1fe72a19-eaba-46a7-89e1-f5f35a86d0f3" alt=""><figcaption></figcaption></figure>

### **Setup Ushahidi Callback in Africa's Talking**

1. Login to Africa's Talking Dashboard and click on app

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FlbypCGqvWyeLcumm5eBz%2F7-AppDashboard.png?alt=media&#x26;token=b20c65c4-2021-4d7c-bdd6-67ef42adecd7" alt=""><figcaption></figcaption></figure>

2. Click on **SMS -> Callback URLs -> Incoming Messages**
3. Enter the Ushahidi's callback URL and click **Submit.**

The URL is your deployment backend's API URL, ending with "/sms/africas-talking"

{% hint style="info" %}
The API URL is often slightly different from your deployment's website URL.&#x20;

* If you are using the ushahidi.io hosting service, you will always need to insert ".api" after your subdomain.  Example:
  * Assuming your deployment's URL address is <mark style="color:green;">**My-Deployment**</mark><mark style="color:yellow;">.ushahidi.io</mark>
  * The API URL for your deployment would be: <mark style="color:green;">**My-Deployment**</mark><mark style="color:red;">**.api**</mark><mark style="color:yellow;">.ushahidi.io</mark>
* Consult with your system administrator if you are configuring a deployment hosted outside of ushahidi.io
* Don't forget to append "/sms/africas-talking" to the resulting API URL
  {% endhint %}

e.g. <https://quakemap.api.ushahidi.io/sms/africas-talking>

<figure><img src="https://1490970077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGBEUb85x3qZ9AiwfCkhF%2Fuploads%2FjBzwcumbDJoh6n224DXb%2F6-AppDashboardInboxCallback.png?alt=media&#x26;token=aff958f0-8930-4081-86e2-386c1e969640" alt=""><figcaption></figcaption></figure>
