# "How to Connect Hormuud SMS to On-Chat"

> "On-Chat integrates with Hormuud, Somalia's leading telecom, so your team can manage SMS conversations from Somali customers in a shared inbox."

URL: https://on-chat.live/guides/how-to-connect-hormuud-sms-to-on-chat/
Last updated: 2026-11-14

## Introduction
Hormuud Telecom is Somalia's largest telecommunications company, providing mobile voice, data, and SMS services across Somalia. With Hormuud integrated into On-Chat, your support team can receive and respond to SMS messages from Somali customers in a centralized shared inbox, complete with automation and routing tools tailored for local mobile networks.

**SEO Keywords:** Hormuud SMS integration, Somalia SMS helpdesk, Hormuud On-Chat, Somali SMS customer service, Hormuud API, Somalia telecom SMS support

## Prerequisites
- An active Hormuud business account with SMS API access
- Hormuud API credentials (API key, username, or partner access)
- On-Chat account with admin access
- A Hormuud short code or virtual number for two-way SMS messaging
- Ability to configure webhook/callback URLs with Hormuud

## Step 1: Obtain Hormuud SMS API Access
Contact Hormuud Telecom's business partnerships team to request SMS API access for your organization. Once approved, you will receive API credentials (API key or partner credentials) needed to send and receive SMS messages programmatically via Hormuud's network.

## Step 2: Register Your Short Code or Sender ID
Work with Hormuud to register a short code or sender ID for two-way SMS messaging. This is the identifier your Somali customers will text to initiate conversations. Hormuud will provide configuration details for routing inbound messages.

## Step 3: Create an SMS Inbox in On-Chat
In On-Chat, go to **Settings** → **Inboxes** → **New Inbox** and select **SMS**. Choose **Hormuud** as the provider. Enter your API credentials and registered short code or sender ID. Save to generate your On-Chat webhook URL.

## Step 4: Configure the Inbound SMS Webhook
Provide your On-Chat webhook URL to Hormuud's technical team for inbound SMS routing configuration. Hormuud will route all SMS messages sent to your short code to the On-Chat webhook, creating new conversations in your inbox.

## Step 5: Assign Agents and Configure Routing
In On-Chat, navigate to **Settings** → **Inboxes** → select your Hormuud inbox → **Collaborators**. Add agents who will handle Somali customer SMS conversations. Set up routing rules to distribute conversations among available agents.

## Step 6: Test the Integration
Send a test SMS from a Hormuud Somali mobile number to your registered short code. Verify the message appears in your On-Chat inbox. Reply from an agent and confirm the customer receives the reply via Hormuud's network.

## Best Practices
- Use Somali language in canned responses to serve local customers effectively
- Coordinate with Hormuud's business support team for any network-level issues
- Use On-Chat automation to send immediate acknowledgment replies to Hormuud SMS messages
- Monitor message delivery rates and work with Hormuud to resolve any delivery failures

## Keep reading

- [How to Build a WhatsApp Chatbot Without Code](https://on-chat.live/guides/how-to-build-a-whatsapp-chatbot/): A step-by-step tutorial for building a dynamic WhatsApp chatbot in a visual flow builder, from your first message to live data and agent handoff.
- [Chatbot Flow Design: 12 Best Practices](https://on-chat.live/guides/chatbot-flow-design-best-practices/): Practical rules for designing chatbot conversation flows that customers finish: branching, fallbacks, personalisation, handoff and testing.
- [Make Your Chatbot Dynamic with Webhooks](https://on-chat.live/guides/dynamic-chatbot-webhooks/): Connect your chatbot flows to live data. Learn how webhooks, expressions and splits turn a scripted bot into one that answers with real information.