> For the complete documentation index, see [llms.txt](https://ajuda.digitalsac.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.digitalsac.io/digicrm/operacao-uso-do-sistema/configuracoes/configuracoes-gerais/integracoes/sms-rcs.md).

# SMS/RCS

A aba **SMS / RCS** guarda as credenciais do provedor (Comtele) usadas pelas Campanhas SMS/RCS e pelo envio de SMS na recuperação de senha. É aqui que o administrador informa o token, a API Key, cria a conta no provedor e liga recursos como o link de recuperação por SMS.

**Caminho:** menu lateral → **Configurações** → **Configurações Gerais** → aba **Integrações** → sub-aba **SMS / RCS**

Permissão: administrador do tenant.

\[\[FOTO]]

***

### As duas credenciais

O provedor tem **duas plataformas**, cada uma com a própria credencial — elas **não são intercambiáveis**:

| Campo                                       | Origem                            | O que habilita                                                                           |
| ------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------- |
| **Token de Autenticação (painel antigo)**   | Gerado em `sms.comtele.com.br`    | Envio padrão de SMS (individual e em massa)                                              |
| **API Key do envio avançado (portal novo)** | Gerada em `portal.comtele.com.br` | Envio em lote, agendamento, cancelamento, status de entrega, links rastreáveis e **RCS** |

Pode-se preencher **uma ou as duas**: com só a API Key, tudo funciona pelo portal novo; com só o token, o envio funciona pela plataforma clássica (sem links rastreáveis). O cliente pode usar **conta própria** contratada direto com o provedor — basta colar as credenciais.

\[\[FOTO]]

***

### Saldo

O card **Saldo disponível** consulta o provedor em tempo real:

* Conta do **portal novo**: saldo **em reais** (ex.: R$ 721,33).
* Conta do **painel antigo**: saldo **em créditos** (1 crédito = 1 mensagem tarifada).

O botão de atualizar fica ativo assim que qualquer credencial estiver preenchida.

***

### Criar conta

Para clientes sem conta no provedor, o botão **Criar conta** abre o cadastro (nome, e-mail, celular, CPF **ou** CNPJ, senha). Pontos importantes:

* Antes do formulário, um aviso explica que a conta criada fica **vinculada à conta DigitalSac como subconta** — créditos e cobrança administrados por ela. Quem preferir conta independente contrata direto com o provedor.
* **CPF/CNPJ é validado** pelos dígitos verificadores (incluindo o **CNPJ alfanumérico**, formato vigente desde 2026).
* Senha: mínimo 8 caracteres com maiúscula, minúscula, número e caractere especial.
* Após criar, a credencial de acesso é fornecida pelo suporte — a chave de API da subconta é gerada manualmente no painel do provedor (política de segurança dele).

\[\[FOTO]]

***

### Recuperação de senha por SMS

O toggle **Enviar link de recuperação por SMS** complementa o e-mail do "esqueci a senha":

* Usuário com **celular cadastrado** recebe o link de redefinição também por SMS (encurtado automaticamente quando há API Key — o link com token ocuparia 3 SMS; encurtado cabe em 1).
* Usuário **sem e-mail** cadastrado passa a conseguir recuperar a senha só pelo celular.
* As mensagens são **cobradas da conta do próprio tenant** — nunca da conta da plataforma. Por isso o toggle só habilita com uma credencial preenchida, e se as credenciais forem removidas ele se desliga sozinho.
* Falha no SMS não trava a recuperação: o e-mail continua sendo enviado normalmente.

\[\[FOTO]]

***

### Tabela de preços

Com a API Key configurada, a **Tabela de preços** lista as rotas contratadas com o valor por mensagem de **envio** e de **resposta** (ex.: Marketing R$ 0,10 / Premium R$ 0,12). Rotas de **RCS**, quando habilitadas pelo provedor, aparecem automaticamente na mesma tabela.

O **tipo de envio não é fixado aqui** — ele é escolhido a cada campanha, na tela de envio.

\[\[FOTO]]

***

### Mensagens e erros comuns

| Situação                                 | Comportamento                                          |
| ---------------------------------------- | ------------------------------------------------------ |
| Token de conta própria (fora da revenda) | Aviso informativo; as configurações salvam normalmente |
| Credencial inválida no provedor          | O erro aparece no primeiro envio/consulta de saldo     |
| CPF/CNPJ inválido no cadastro            | Validação imediata no formulário                       |
| Toggle de recuperação sem credencial     | Fica desabilitado com a explicação na legenda          |
