> For the complete documentation index, see [llms.txt](https://docs.sprinthub.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sprinthub.com/en/topics/integrations/integrations-sms.md).

# Integrations - SMS

## 📱 SMS Module

Send and receive SMS directly through SprintHub using your provider (such as Twilio). Everything in one place: statistics, ready-made templates, and full history.

***

### 1. Setting up the integration ⚙️

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FdQP49CjGXQk1Psb1KTis%2F1_sms_settings_integration.png?alt=media&amp;token=7ddd2136-d5d4-4f8d-8941-4be448b71f9e" alt=""><figcaption></figcaption></figure>

Go to **System Settings → Integrations → SMS** and fill in:

* **Provider**: the service that will send the messages (e.g., Twilio).
* **Account SID**: your account identifier with the provider.
* **Auth Token**: account access password. Do not share. 🤫
* **Outgoing numbers**: numbers that appear as the sender. Click **+ Add** and enter:
  * **Number** with country code.
  * **First name** to identify (e.g., "Sales").
  * **Description** (optional).
  * Purple toggle button turns on/off, trash deletes.

> 💡 Without registered numbers, any number in your provider account can be used.

***

### 2. Setting up the receiving webhook

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FEIc9ZNi3k9XYInAOwbjm%2F2_sms_settings_webhook.png?alt=media&amp;token=97fa3a62-c986-449e-8260-7a3128db808f" alt=""><figcaption></figcaption></figure>

The **webhook** is the path the provider uses to deliver replies to SprintHub.

Copy the **WEBHOOK URL** and configure it in the provider panel (Twilio example):

1. Access **console.twilio.com**.
2. Go to **Phone Numbers → Manage → Active numbers**.
3. Click the desired number.
4. In **Messaging Configuration**, in the field **"A message comes in"**:
5. Select **Webhook** and paste the URL.
6. Set the method to **HTTP POST**.
7. Click on **Save**.
8. Repeat for each number.

Then click **Save** in SprintHub. Done, the received messages will appear automatically. ✨

***

### 3. Dashboard 📊

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FCcvTEMSRSbk8dLddmYHC%2F3_sms_dashboard.png?alt=media&amp;token=8cf825f6-ac8f-4764-8cca-924055aa0f9b" alt=""><figcaption></figcaption></figure>

Visual panel with the performance of your sends.

**Filters (top):**

* **Responsible party** — by user.
* **Period** — date range.
* **Export** — downloads the period's data.

**Indicators:**

* **Total messages** — overall total.
* **Sent / Received** — volume and percentage.
* **Daily, weekly, and monthly averages**.
* **Average characters** — useful for estimating cost (each SMS = 160 characters).

**Charts:**

* **Message status** — success vs. failures.
* **Daily sends** — volume per day (hover to see details).
* **Message direction** — sent vs. received.
* **Daily direction** — comparison over time.

> 💡 Use the Dashboard to identify peaks and validate the operation's return.

***

### 4. Creating a template

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2F9NScrhXampUQ1kRnAxCU%2F4_sms_template_create.png?alt=media&amp;token=aa91d2fd-ac4b-4177-a6a3-38e89f97c1d5" alt=""><figcaption></figcaption></figure>

Templates are ready-made messages for reuse. Go to **Templates → New Template**:

* **Active** — available for use when turned on.
* **Template name** — to find easily (e.g., "Welcome").
* **Content** — message text (limit of 160 characters).
* **Tag icon** — inserts dynamic variables (e.g., contact name).
* **Access permission** — which users and departments can use it.

Click on **Create** to save.

***

### 5. Template list

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FYIdKMdvl94AFvv8G4Vn9%2F5_sms_template_list.png?alt=media&amp;token=18d1a8dc-8197-44be-b9b9-e355989fe62a" alt=""><figcaption></figcaption></figure>

All created templates are here:

* **Status**, **First name**, **Content**, **Responsible party**, **Created on**.
* **Actions**: edit (pencil) or delete (trash).

Use the search at the top to filter by name.

***

### 6. Sending a message 🚀

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FGR52F5BYVjJY9Rmh8ea6%2F6_sms_send.png?alt=media&amp;token=b9c97270-0a23-42bd-b220-0ed895a90940" alt=""><figcaption></figcaption></figure>

In **Messages**, click on **Send Message** and fill in:

* **Contact** — search by the record.
* **Contact number** — auto-filled or manual.
* **Outgoing number** — which of your numbers will be the sender.
* **Template** — optional, fills in the content automatically.
* **Content** — message text (160 characters).

Click on **Send**.

***

### 7. Message history

<figure><img src="https://684109703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2F0xdwVX0uXBmzIk3vFzCc%2F7_sms_history.png?alt=media&amp;token=3a9ade07-f39b-450c-8779-bf81c6ac49f9" alt=""><figcaption></figcaption></figure>

In **Messages** you can see everything that was sent and received:

* **Status**, **To**, **From**, **Content**, **Service**, **Responsible party**, **Date**.
* **Magnifying glass** — opens the full details.

**At the top:**

* **Send Message** — shortcut for a new send.
* **Responsible party** and **Advanced filter** — refine the search.
* **Search by destination number**.
* **Refresh** — reloads the list.

> 💡 Nothing is lost: you can audit any send at any time.

***

Done! Now just start using it and supercharge communication with your contacts. 📲
