"How to Connect Shaqodoon to On-Chat"

Introduction

Shaqodoon is a Somali SMS messaging provider that enables organizations to reach customers via mobile in Somalia and the Horn of Africa region. By integrating Shaqodoon with On-Chat, support teams can receive and respond to inbound SMS messages from Somali customers in a shared inbox, with automated routing, canned responses, and conversation tracking — making it easy to deliver organized, responsive SMS support across the region.

SEO Keywords: Shaqodoon On-Chat integration, Shaqodoon SMS helpdesk, Shaqodoon customer support Somalia, SMS inbox Shaqodoon On-Chat, Shaqodoon API two-way SMS, Somalia SMS support platform

Prerequisites

• An active Shaqodoon account with API access
• Shaqodoon API credentials (username, password, or API key)
• A shortcode or virtual number configured for inbound SMS
• On-Chat account with admin access
• Ability to configure inbound message webhooks in Shaqodoon

Step 1: Obtain Your Shaqodoon API Credentials

Log in to your Shaqodoon account and navigate to the API or developer settings section. Copy your API key or authentication credentials and note the API endpoint URL. You will also need your sender ID or shortcode that customers will message. Keep these credentials secure.

Step 2: Provision an Inbound SMS Number or Shortcode

Verify with Shaqodoon that your account has a number or shortcode configured for receiving inbound SMS from customers. If not, contact Shaqodoon support to provision one. Two-way SMS capability is required for the On-Chat integration to work.

Step 3: Create an SMS Inbox in On-Chat

In On-Chat, go to Settings → Inboxes → New Inbox and select SMS. Choose Shaqodoon as the SMS provider. Enter your API credentials, the Shaqodoon API endpoint, and your sender number. Save the inbox to generate the On-Chat webhook URL for inbound messages.

Step 4: Configure the Inbound Webhook in Shaqodoon

In your Shaqodoon account settings, find the inbound message delivery configuration and enter the On-Chat webhook URL. Set the delivery method to HTTP POST. This tells Shaqodoon to forward all incoming customer SMS messages to On-Chat, automatically creating new conversations.

Step 5: Add Agents and Configure Conversation Routing

In On-Chat, go to Settings → Inboxes → select your Shaqodoon inbox → Collaborators. Add agents who will handle Shaqodoon SMS conversations. Enable auto-assignment to distribute new conversations to available agents based on load or round-robin assignment rules.

Step 6: Test and Validate the Integration

Send a test SMS to your Shaqodoon number or shortcode. Confirm the message appears in On-Chat as a new conversation. Reply from an agent and verify the customer receives the response via SMS. Check message delivery logs in Shaqodoon and conversation history in On-Chat for accuracy.

Best Practices

• Use On-Chat automation to send immediate auto-replies in Somali or English when customers first message via Shaqodoon
• Assign the Shaqodoon inbox to a dedicated regional support team familiar with Somali customer needs
• Apply On-Chat conversation labels to track issue types and improve response quality over time
• Monitor Shaqodoon message logs regularly to catch delivery failures or number provisioning issues