> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.smstools.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# GHL setup guide - how to setup Smstools in HighLevel CRM as a custom conversation provider

# Step 1 – Gather the Required Information from Smstools

* **Log in** to your Smstools account.
* Navigate to **“Extra” > “Channels”**. Under **“My Channels”**, you’ll see the list of Virtual SMS numbers currently associated with your account.
* **Copy your number** in international format (e.g., `32460123456` for Belgium, `491234567890` for Germany). We recommend pasting it into a temporary document for easy access.
* Then, go to **“Developers” > “API & Webhooks”**. Here, you’ll find your **Client ID** and **Client Secret**—you’ll need both for integration purposes.

# Step 2 – Install Smstools in HighLevel (GHL)

* **Log in** to your HighLevel agency account.
* If you haven’t already, **create a sub-account** for the client or business you want to connect.
* **Switch to the sub-account** by logging in or selecting it from your agency dashboard.
* Navigate to the **App Marketplace**.
* Search for **“Smstools”** and click **Install**.
* Once installed, return to the **App Marketplace**, go to **Installed Apps**, and click on **Smstools** to begin the authorization process.
* You will be prompted to enter the **Client ID**, **Client Secret**, and **Phone Number** you gathered in **Step 1**.
* **Enter the details** and confirm to complete the installation.
* If everything is set up correctly, you will see the message: **“You are now connected to Smstools.”**

![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/b/7/7bb7f1f7a2418c00/image_1b7kmtg.png)
# Step 3 – Set Smstools as the Default Provider
* Go to **Settings** > **Phone Numbers**.
* In the **Provider** dropdown, select **Smstools**.
* Click **Save** to confirm your selection.
![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/b/7/7bb7f1f7a2418c00/image_sznt2k.png)

# Step 4 – Test the SMS Conversation

1. Navigate to **Contacts** and create a **test contact** using a valid mobile phone number.
2. Go to **Conversations** > **New Conversation** > **Direct Message**.
3. Select your **test contact** and send an **outbound SMS**.
4. Check the recipient's phone to ensure the **Sender ID (phone number)** is displayed correctly.
5. **Reply to the message** from the test phone.
6. If everything is working properly, you’ll see both the **outbound** and **inbound** messages appear in the **conversation view**.

✅ You’ve successfully completed your test!

![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/b/7/7bb7f1f7a2418c00/image_1azvrxi.png)

# Step 5 – Test SMS Automation Workflow
1. Go to **Automations** and create a **new workflow from scratch**.
2. Set the **Trigger** to **Customer Replied** – this ensures the workflow is activated whenever an inbound SMS is received.
3. Add an **Action**: **Send SMS** – configure your auto-reply message here.
4. **Save** and **Publish** the workflow.⚠️ *Note: The workflow will not run unless it is published.*
5. Now, send a message to your connected virtual number to test if the **automated SMS reply** is triggered correctly.
✅ If everything is working, you’ll see the incoming message and the automated reply in the **Conversations** view.

![](https://storage.crisp.chat/users/helpdesk/website/-/7/b/b/7/7bb7f1f7a2418c00/image_ta2f3.png)

**Thank you for using our GHL integration!**
If you have any questions or encounter any issues, feel free to reach out to us at [**support@smstools.com**]() — we're happy to help! 😊