For the complete documentation index, see llms.txt. This page is also available as Markdown.

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 MarketingCampanha 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.

Atualizado