# 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="/files/t6y8Ufmpcdwsa2YBfJqM" 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="/files/KB0gm8wg8R6L95GnHifJ" 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="/files/MSZGJ8P3qHzIbgYSrOXI" 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="/files/g0e3FhRMXHahXzmRyN1A" 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="/files/tCJL55b09XHXh4I3Nm69" 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="/files/DjAzCLMtAGmdQaSBS1Hh" 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="/files/rjwNLGwUg4r0Rb78buzv" 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. 📲


---

# Agent Instructions: 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/topicos/integracao/integracoes-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.