"getting-started"
"How to Connect Jasmin SMS Gateway to On-Chat"
"Connect Jasmin open-source SMS gateway to On-Chat and handle inbound SMS customer conversations in a shared team inbox."
Introduction
Jasmin is a free, open-source SMS gateway built on SMPP protocol that lets businesses send and receive SMS messages using their own infrastructure or third-party SMSC connections. By integrating Jasmin with On-Chat, your team can route inbound SMS messages directly into On-Chat's shared inbox, enabling collaborative customer support with automation, canned responses, and agent routing.
SEO Keywords: Jasmin SMS gateway On-Chat, open-source SMS helpdesk, Jasmin SMPP integration, Jasmin SMS customer support, self-hosted SMS gateway helpdesk, Jasmin API On-Chat setup
Prerequisites
- A running Jasmin SMS Gateway instance (self-hosted)
- Jasmin HTTP API or SMPP credentials configured
- On-Chat account with admin access
- A phone number or MSISDN configured in Jasmin for two-way SMS
- Access to Jasmin HTTP API for receiving inbound message webhooks
Step 1: Confirm Jasmin HTTP API Is Running
Ensure your Jasmin instance is running and the HTTP API is accessible. Test connectivity by sending a simple REST request to your Jasmin HTTP API endpoint. The HTTP API is used by On-Chat to submit outbound SMS replies to customers.
Step 2: Retrieve Jasmin HTTP API Credentials
In your Jasmin configuration, find the HTTP API username and password, as well as the base URL for your Jasmin server. These credentials are required when setting up the SMS inbox in On-Chat.
Step 3: Create an SMS Inbox in On-Chat
In On-Chat, navigate to Settings → Inboxes → New Inbox and select SMS. Choose Jasmin as the provider. Enter your Jasmin API base URL, username, password, and sender ID. Save to generate the On-Chat inbound webhook URL.
Step 4: Configure Inbound Message Delivery in Jasmin
In Jasmin, configure the MO (Mobile Originated) message router or HTTP delivery module to forward inbound messages to your On-Chat webhook URL. When a customer sends an SMS to your number, Jasmin will POST the message to On-Chat automatically.
Step 5: Add Agents to the Inbox
In On-Chat, go to Settings → Inboxes → select your Jasmin inbox → Collaborators. Add the support agents who will manage SMS conversations from this inbox. Enable auto-assignment to distribute new conversations among available agents.
Step 6: Test the Full Message Flow
Send a test SMS to your Jasmin-managed number. Confirm the message appears in your On-Chat inbox as a new conversation. Reply from the agent and verify the outbound message is delivered through Jasmin to the customer's phone.
Best Practices
- Monitor Jasmin server logs regularly to detect delivery failures or SMSC connectivity issues
- Use On-Chat automation to send immediate acknowledgment messages to customers on inbound SMS
- Scale Jasmin horizontally if handling high SMS volumes to prevent message queuing delays
- Use On-Chat conversation tags to categorize SMS issues by type for better reporting