> 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/integration/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="/files/f5874dd27578705f241fd7659669b03e2fd413ac" 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**: the account access password. Do not share it. 🤫
* **Outgoing numbers**: numbers that appear as the sender. Click **+ Add** and enter:
  * **Number** with country code.
  * **Name** to identify it (e.g., "Sales").
  * **Description** (optional).
  * Purple on/off button toggles it, trash can removes it.

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

***

### 2. Setting up the receiving webhook

<figure><img src="/files/a75b3f4a8d3bd2a8fdb84ab27ae74cce789f7502" alt=""><figcaption></figcaption></figure>

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

Copy the **WEBHOOK URL** and configure it in the provider dashboard (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 **Save**.
8. Repeat for each number.

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

***

### 3. Dashboard 📊

<figure><img src="/files/f39b0fcdc91d325670459433013d0381be054d51" alt=""><figcaption></figcaption></figure>

Visual panel with the performance of your sends.

**Filters (top):**

* **Owner** — by user.
* **Period** — date range.
* **Export** — downloads the period 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 by day (hover to see details).
* **Message direction** — sent vs. received.
* **Daily direction** — comparison over time.

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

***

### 4. Creating a template

<figure><img src="/files/95fb72da5ed8c65ff9d508330147e9f72e22aa81" alt=""><figcaption></figcaption></figure>

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

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

Click **Create** to save.

***

### 5. Template list

<figure><img src="/files/0ec3d7f502e316a47bc36078981a0325731b4577" alt=""><figcaption></figcaption></figure>

All created templates are here:

* **Status**, **Name**, **Content**, **Owner**, **Created on**.
* **Actions**: edit (pencil) or delete (trash can).

Use the search at the top to filter by name.

***

### 6. Sending a message 🚀

<figure><img src="/files/07d7908fcc76dd547f3a5447feb6ed9dd1009f09" alt=""><figcaption></figcaption></figure>

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

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

Click **Send**.

***

### 7. Message history

<figure><img src="/files/c07a13e5fa28e884de566c74c2e4d7ba44ca2ef4" alt=""><figcaption></figcaption></figure>

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

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

**At the top:**

* **Send Message** — shortcut for a new send.
* **Owner** 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 boost 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:

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

The question should be specific, self-contained, and written in natural language.
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.