> 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/topicos/integracoes/integracoes-sms.md).

# Integrações - SMS

## 📱 Módulo de SMS

Envie e receba SMS direto pelo SprintHub usando seu provedor (como o Twilio). Tudo em um só lugar: estatísticas, modelos prontos e histórico completo.

***

### 1. Configurando a integração ⚙️

<figure><img src="https://3534414179-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>

Vá em **Configurações do Sistema → Integrações → SMS** e preencha:

* **Provedor**: o serviço que vai enviar as mensagens (ex.: Twilio).
* **Account SID**: identificador da sua conta no provedor.
* **Auth Token**: senha de acesso da conta. Não compartilhe. 🤫
* **Números de saída**: números que aparecem como remetente. Clique em **+ Adicionar** e informe:
  * **Número** com código do país.
  * **Nome** para identificar (ex.: "Vendas").
  * **Descrição** (opcional).
  * Botão roxo liga/desliga, lixeira remove.

> 💡 Sem números cadastrados, qualquer número da sua conta no provedor pode ser usado.

***

### 2. Configurando o webhook de recebimento

<figure><img src="https://3534414179-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>

O **webhook** é o caminho que o provedor usa para entregar as respostas no SprintHub.

Copie a **URL DO WEBHOOK** e configure no painel do provedor (exemplo Twilio):

1. Acesse **console.twilio.com**.
2. Vá em **Phone Numbers → Manage → Active numbers**.
3. Clique no número desejado.
4. Em **Messaging Configuration**, no campo **"A message comes in"**:
5. Selecione **Webhook** e cole a URL.
6. Defina o método como **HTTP POST**.
7. Clique em **Save**.
8. Repita para cada número.

Depois clique em **Salvar** no SprintHub. Pronto, as mensagens recebidas vão aparecer automaticamente. ✨

***

### 3. Dashboard 📊

<figure><img src="https://3534414179-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>

Painel visual com o desempenho dos seus envios.

**Filtros (topo):**

* **Responsável** — por usuário.
* **Período** — intervalo de datas.
* **Exportar** — baixa os dados do período.

**Indicadores:**

* **Total de mensagens** — soma geral.
* **Enviadas / Recebidas** — volume e percentual.
* **Médias diária, semanal e mensal**.
* **Média de caracteres** — útil para estimar custo (cada SMS = 160 caracteres).

**Gráficos:**

* **Status das mensagens** — sucesso vs. falhas.
* **Envios diários** — volume por dia (passe o mouse para ver detalhes).
* **Direção das mensagens** — enviadas vs. recebidas.
* **Direção diária** — comparativo ao longo do tempo.

> 💡 Use a Dashboard para identificar picos e validar o retorno da operação.

***

### 4. Criando um modelo

<figure><img src="https://3534414179-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>

Modelos são mensagens prontas para reutilizar. Vá em **Modelos → Novo Modelo**:

* **Ativo** — disponível para uso quando ligado.
* **Nome do modelo** — para localizar fácil (ex.: "Boas-vindas").
* **Conteúdo** — texto da mensagem (limite de 160 caracteres).
* **Ícone de etiqueta** — insere variáveis dinâmicas (ex.: nome do contato).
* **Permissão de acesso** — quais usuários e departamentos podem usar.

Clique em **Criar** para salvar.

***

### 5. Lista de modelos

<figure><img src="https://3534414179-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>

Todos os modelos criados ficam aqui:

* **Status**, **Nome**, **Conteúdo**, **Responsável**, **Criado em**.
* **Ações**: editar (lápis) ou excluir (lixeira).

Use a busca no topo para filtrar por nome.

***

### 6. Enviando uma mensagem 🚀

<figure><img src="https://3534414179-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>

Em **Mensagens**, clique em **Enviar Mensagem** e preencha:

* **Contato** — busque pelo cadastro.
* **Número do contato** — preenchido automático ou manual.
* **Número de saída** — qual dos seus números será o remetente.
* **Modelo** — opcional, preenche o conteúdo automaticamente.
* **Conteúdo** — texto da mensagem (160 caracteres).

Clique em **Enviar**.

***

### 7. Histórico de mensagens

<figure><img src="https://3534414179-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>

Em **Mensagens** você vê tudo que foi enviado e recebido:

* **Status**, **Para**, **De**, **Conteúdo**, **Serviço**, **Responsável**, **Data**.
* **Lupa** — abre os detalhes completos.

**No topo:**

* **Enviar Mensagem** — atalho para novo disparo.
* **Responsável** e **Filtro avançado** — refinam a busca.
* **Pesquisa por número de destino**.
* **Atualizar** — recarrega a lista.

> 💡 Nada se perde: você pode auditar qualquer envio a qualquer momento.

***

Pronto! Agora é só começar a usar e turbinar a comunicação com seus contatos. 📲