Integrating SMS8 with CRM Messaging

This guide provides step-by-step instructions for connecting SMS8 (SIM-based SMS) to your CRM Messaging account. By following this process, you will enable credentials for the web app and inbound webhooks for two-way messaging.

Prerequisites

Before starting the integration, ensure you have the following:

1. SMS8 Account: At least one mobile device/phone linked and active in the SMS8 app.
2. API Key: Located in your SMS8 dashboard or mobile app settings.
3. Device Handle: Identify the deviceID and simSlot (usually 0 for the first SIM). The handle follows the format: deviceID|simSlot (e.g., 10475|0).

Step 1: Access Integration Settings

You can reach the configuration screen via two paths:

Option A: Integration Gateway

1. Navigate to the left-hand menu and select Integration Gateway.
2. Under the SMS/MMS Connections section, find and click Connect SMS8.

Option B: Settings Tab

1. Sign in as an Account Admin.
2. Go to Settings > API Configuration (“Your third party integration information”).
3. Under Integrate Your Own API Account, select SMS8 from the provider dropdown list.

Step 2: Configure the Integration Form

Fill in the following fields accurately to establish the connection:

Field	Description
From Number / ID	The mobile number customers see. Use E.164 format. This maps inbound messages to the correct inbox.
Tab Name	A custom label for this line in your UI (e.g., “Main SIM Line”).
API Key	Your SMS8 API key. This is stored using encryption.
Device ID / devices	Enter your handle: `deviceID
SMS/MMS/WhatsApp	Automatically forced to SMS-only for this provider type.

Note on Webhook URL

The form displays a read-only Incoming Webhook URL. For this integration, use:

https://app.crm-messaging.cloud/index.php/sms8/webhook

Copy this URL; you will need it for the next step.

Click Save. A success message will appear, and a new sms8 row will be created in your provider table.

Step 3: Configure SMS8 Webhooks

To receive messages, you must tell SMS8 where to send them:

1. Log in to the SMS8 Dashboard.
2. Locate the Incoming Message Webhook setting.
3. Paste the Webhook URL copied from CRM Messaging.
4. Enable events for Received SMS.

Step 4: Outbound & Inbound Testing

• Outbound: When you send a message, the app communicates with app.sms8.io using your stored credentials.
• Inbound: When a message is received on your phone, SMS8 POSTs to your webhook. If the signature and device ID match, the conversation appears in the CRM Messaging inbox.

Troubleshooting

Symptom	Resolution
400 — Signature not found	Ensure the SMS8 dashboard is configured to send headers.
401 — Validation failed	Check for extra spaces in your API Key. Re-save the key in CRM Settings.
Inbound messages missing	Verify the `deviceID
Field required error	Ensure both API Key and Device ID are filled before clicking Save.