> For the complete documentation index, see [llms.txt](https://documentation.proto.cx/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.proto.cx/docs/modules/ai-agents/publishing/africas-talking.md).

# Africa's Talking

{% hint style="info" %}
Publish to Africa's Talking with the Total plan and above.
{% endhint %}

{% hint style="warning" %}
Requires an Africa's Talking account.
{% endhint %}

Publishing to Africa's Talking lets your audience interact with the AI agent — and later a [live agent](/docs/modules/ai-agents/workflows-and-actions/human-handoff.md) — in an Africa's Talking thread.

In the agent's **Publish** tab, create an Africa's Talking channel or select an existing one to open its settings.

***

## Basic settings

| Setting                   | Description                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------- |
| **Name**                  | Internal name distinguishing this channel from other Africa's Talking instances.    |
| **Default chat language** | Set from the agent's [Agent settings](/docs/modules/ai-agents/manage-ai-agents.md). |
| **Icon**                  | The channel's avatar, seen by live agents in the [Inbox](/docs/modules/inbox.md).   |

Select **Save** to confirm edits.

***

## Connect to Africa's Talking

Three values are required: **Username**, **API Key**, and **Short code**. You'll also add a Proto webhook.

1. Log in to Africa's Talking and create a **New Team**.
2. In the team, create an **App** — set its Name, Username, Country, and Currency.
3. Open the app's dashboard and copy the **Username** into Proto's Username field.
4. Go to **Settings → API Key**, generate one, and paste it into Proto's API Key field.
5. Go to **SMS → Shortcodes → My Shortcodes**, and apply for a short code via the request form.
6. Once received, paste the short code into Proto's Shortcode field.
7. In Proto's Africa's Talking **Webhook** accordion, copy the **Webhook URL**.
8. In Africa's Talking, go to **SMS → SMS Callback URLs → Incoming Messages** and add the Webhook URL.