> 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. 📲


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sprinthub.com/en/topics/integrations/integrations-sms.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.