> 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/campanha-sms-rcs.md). # Campanha SMS/RCS **Campanha SMS/RCS** envia mensagens em massa (SMS e, quando habilitado, RCS) pelo provedor Comtele, com saldo em tempo real, custo estimado antes do disparo, agendamento, cancelamento e relatório de entrega por contato. **Caminho:** menu lateral → **Comunicação e Marketing** → **Campanha SMS/RCS** Requisito: plano **Premium** e credenciais configuradas em **Configurações Gerais → Integrações → SMS / RCS** (ver Configuração de SMS/RCS). Sem credencial, a tela mostra um aviso com atalho para as Configurações. \[\[FOTO]] *** ### As abas da tela | Aba | O que faz | | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | | **Campanha** | Composição e disparo do SMS em massa | | **RCS** | Envio de mensagens ricas (texto longo, card, carrossel, arquivo) — aparece "RCS não habilitado" enquanto a conta não tiver rota RCS | | **Histórico** | Envios anteriores com status, progresso, cancelamento, sincronização de entrega e relatórios PDF/CSV | | **Respostas recebidas** | Quem respondeu aos seus SMS — respostas como "PARE" alimentam a lista Não perturbe automaticamente | \[\[FOTO]] *** ### Aba Campanha #### Saldo e tipo de envio * O card **Saldo disponível** mostra o saldo da conta no provedor: * Conta do **portal novo** (API Key): saldo **em reais** (ex.: R$ 721,33) com a estimativa "≈ N mensagens disponíveis". * Conta do **painel antigo** (token): saldo **em créditos** (1 crédito = 1 mensagem tarifada). * O seletor **Tipo de envio** lista as rotas contratadas com o preço por mensagem (ex.: Marketing — R$ 0,10; Premium — R$ 0,12). Disponível para contas com API Key do portal novo; o tipo é escolhido **a cada campanha**. * O **custo estimado** do disparo (destinatários × mensagens tarifadas × preço) aparece ao lado do contador de caracteres e fica **vermelho** quando ultrapassa o saldo. \[\[FOTO]] #### Configurações de envio * **Agendar envio (opcional):** escolha data/hora futura e o provedor segura o disparo. Deixe vazio para enviar imediatamente. * **Encurtar links automaticamente:** URLs da mensagem viram links curtos rastreáveis (`ctle.io/...`) — economiza caracteres e permite medir cliques. Disponível com API Key do portal novo. * **Respeitar lista Não perturbe:** ligado por padrão; números com opt-out ativo são excluídos do envio e registrados no relatório como "Número na lista Não perturbe". \[\[FOTO]] #### Destinatários e mensagem * **Importar contatos:** liga a seleção pela base de contatos, com busca, filtro por **carteira** e por **etiquetas**, botão "Selecionar todos" e importação por **CSV** (uma coluna de números). * Sem importar, digite os números diretamente (Enter adiciona; vírgula separa). * O campo **Mensagem** tem contador de caracteres com as **mensagens tarifadas**: até **160 caracteres = 1 mensagem**; acima disso, o provedor cobra **1 mensagem a cada 153 caracteres**. Um aviso laranja mostra o custo real por destinatário quando a mensagem passa do limite (ex.: "cada destinatário custa R$ 0,20 em vez de R$ 0,10"). \[\[FOTO]] #### Tags e identificação (opcional) Seção recolhível, fechada por padrão, com dois marcadores que **não alteram a mensagem** — servem para localizar e filtrar os envios depois, inclusive no painel do provedor: | Campo | Uso típico | | ----------------- | ----------------------------------------------------------- | | **Tag** | Agrupador da campanha (ex.: `black-friday`, `cobranca`) | | **Personalizado** | Referência externa (ex.: o número do pedido no seu sistema) | Deixando em branco, o sistema preenche sozinho com valores padrão que amarram o envio ao registro do histórico. Os mesmos campos existem na aba RCS. \[\[FOTO]] #### Disparo O envio é feito **em lote** — o sistema entrega todos os números ao provedor em poucas chamadas e responde na hora, sem travar a tela. A notificação mostra aceitos, rejeitados (com motivo por número no relatório) e excluídos por opt-out. Não há mais intervalo entre mensagens: uma campanha de 300 contatos sai em segundos. *** ### Aba RCS Enquanto a conta não tem rota RCS habilitada, a aba mostra **"RCS não habilitado"** com o motivo e o botão **Verificar novamente** — assim que o provedor liberar a rota, o envio destrava sozinho, sem atualização do sistema. Com o RCS ativo, os formatos disponíveis são: | Formato | Conteúdo | | ------------------ | -------------------------------------------------------- | | **Texto simples** | Até 1.000 caracteres | | **Card** | Imagem + título + texto + até 4 botões (com ou sem link) | | **Carrossel** | De 2 a 10 cards | | **Arquivo/Imagem** | Arquivo por URL pública | O envio RCS usa o mesmo agendamento, a mesma lista Não perturbe e cai no mesmo **Histórico** das campanhas de SMS. A habilitação exige o cadastro do **agente RCS** (marca, logo, descrição) junto ao provedor, com aprovação das operadoras. \[\[FOTO]] *** ### Aba Histórico Lista os envios do mês (filtros de mês/ano), com totais, enviados, falhas, data e status: | Status | Significado | | --------------- | ----------------------------------------------------- | | **Processando** | Envio em andamento (contadores sobem em tempo real) | | **Concluído** | Lote entregue ao provedor | | **Agendado** | Aguardando a data programada | | **Cancelado** | Cancelado antes da conclusão | | **Falhou** | Envio não realizado (motivo por contato no relatório) | Ações por envio: * **Cancelar** (ícone laranja): disponível apenas para envios **Agendados** ou **Processando** — cancela no provedor as mensagens ainda não enviadas. Pede confirmação. Envios já concluídos não podem ser cancelados (as mensagens já foram entregues e cobradas). * **Sincronizar entrega** (ícone azul): consulta o provedor e grava o **status real de entrega por contato** (ex.: "entregue com confirmação no aparelho"), visível no relatório e no CSV. Pode ser acionado quantas vezes quiser. Em campanhas muito grandes (acima de \~1.000 mensagens no período), a consulta pode não cobrir todos os contatos de uma vez. * **Estatísticas de cliques** (ícone roxo): para envios com link encurtado, mostra cliques totais e cliques humanos por link — a medida de conversão da campanha. * **PDF / CSV**: relatório completo com contato, número, status de envio, status de entrega e horário. \[\[FOTO]] *** ### Aba Respostas recebidas Mostra as respostas de SMS dos últimos 30 dias, com o contato identificado quando o número existe na base. > **Como as respostas chegam:** o sistema **consulta** o provedor quando esta aba é aberta (ou quando o botão atualizar é acionado) — não há recebimento em tempo real. Enquanto ninguém abrir a aba, uma resposta de opt-out ("PARE") ainda não terá sido registrada na lista Não perturbe. Abra a aba periodicamente, sobretudo após campanhas. * Palavras de opt-out (ex.: **PARE**) registram o número na lista **Não perturbe** automaticamente — o mesmo cadastro usado pelas campanhas de WhatsApp (ver Consentimento de marketing). * O selo **Não perturbe** aparece ao lado de quem já está na lista. \[\[FOTO]] *** ### Mensagens e erros comuns | Situação | Comportamento | | -------------------------------- | ------------------------------------------------------------------ | | SMS não configurado | Banner laranja com botão "Ir para Configurações" | | Saldo/créditos insuficientes | Diálogo com saldo, custo do envio e opção de continuar mesmo assim | | Mensagem acima de 160 caracteres | Aviso laranja com o custo real por destinatário | | Todos os números em opt-out | Envio recusado com aviso | | Já existe envio em andamento | Novo disparo é recusado até o atual concluir | | Números rejeitados pelo provedor | Contam como falha, com o motivo no relatório | *** ### Dicas de uso * Prefira mensagens de até **160 caracteres** — cada caractere a mais pode dobrar o custo da campanha inteira. * Com link na mensagem, deixe o **encurtador ligado**: além de caber no limite, você ganha a contagem de cliques. * Depois de algumas horas do disparo, use **Sincronizar entrega** para ver quem realmente recebeu. * Rotas de marketing podem passar por análise antisspam do provedor no primeiro uso — se o envio constar como "em análise", aguarde alguns minutos. * **Agendamento** usa o fuso horário da empresa configurado no sistema, não o do servidor — o horário que você digita é o horário que vale. * Mensagens com **link em rota de marketing** têm mais chance de bloqueio pelas operadoras; se a entrega falhar consistentemente, teste a rota Premium.