> ## Documentation Index
> Fetch the complete documentation index at: https://docs.robbu.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Campanhas de SMS

> Crie, configure e monitore campanhas de SMS no Invenio Center: público-alvo, agendamento, short code, mensagem personalizada e relatório de desempenho em tempo real.

As **Campanhas de SMS** do Invenio Center permitem o envio em massa e programado de mensagens de texto para públicos segmentados. Ideal para:

* 📣 **Marketing:** promoções, lançamentos e alertas
* 💳 **Cobranças:** lembretes e notificações de vencimento
* 🔔 **Notificações:** confirmações, atualizações e alertas urgentes

***

## Pré-requisito: Público-Alvo

<Warning>
  **Antes de criar uma campanha**, o público deve estar importado no módulo **Público**.

  **Caminho:** Invenio Center > Converter > Público > Importar

  Consulte: [Importação de Público no Invenio Center](https://docs.robbu.global/docs/center/publico-importacao)
</Warning>

***

## Criar Campanha de SMS

**Caminho:** Invenio Center > Converter > Campanhas > SMS > **+ Criar campanha**

<Tip>
  **Acesso direto:** [Campanhas de SMS](https://inveniocenter.robbu.global/painel/campanhas/sms)
</Tip>

<Frame caption="Menu Converter > Campanhas > SMS">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/menu1SMS.png" />
</Frame>

<Frame caption="Listagem de campanhas de SMS">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/menu2SMS.png" />
</Frame>

<Frame caption="Botão + Criar Campanha">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/CriarCampanha.png" />
</Frame>

<Steps>
  <Step title="Descrição da campanha">
    Defina um **nome interno** para identificação, organização e relatórios.

    Visível apenas para fins administrativos (não aparece para o destinatário).
  </Step>

  <Step title="Selecionar público-alvo">
    Selecione o **público previamente importado**. Cada público está vinculado a um **segmento específico**.

    <Frame caption="Seleção de descrição e alvo da campanha">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/Descricao&Alvo2.png" />
    </Frame>
  </Step>

  <Step title="Agendamento e hora limite">
    Configure o início e o controle de tempo do disparo:

    | Opção                  | Descrição                                              |
    | ---------------------- | ------------------------------------------------------ |
    | **Início da campanha** | Data e hora para iniciar os envios                     |
    | **Envio imediato**     | Mantenha a data/hora atual para disparar agora         |
    | **Hora limite**        | Horário de corte — campanha encerrada após esse limite |

    <Frame caption="Configuração de início, fluxo de envio e hora limite">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/Inicio&FluxoEnvio2.png" />
    </Frame>
  </Step>

  <Step title="Fluxo de envio (parcelado)">
    Envie a campanha de forma **graduada** para evitar sobrecarga:

    * Defina a **porcentagem (%)** do público por ciclo
    * Defina o **intervalo em minutos** entre cada ciclo

    **Exemplo:** 20% a cada 15 minutos → campanha de 1.000 contatos concluída em \~1h15.
  </Step>

  <Step title="Contatos em atendimento">
    Defina como lidar com contatos em atendimento ativo:

    * ✅ **Excluir contatos** em atendimento ativo no momento do disparo
    * ✅ **Excluir por interação recente** — evita envio para contatos atendidos no intervalo configurado

    <Frame caption="Configuração de exclusão de contatos em atendimento">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/ContatosEmAtendimento2.png" />
    </Frame>
  </Step>

  <Step title="Selecionar Short Code">
    Escolha o **short code** (número curto) que será utilizado como remetente do SMS.

    <Note>
      **O que é um Short Code?**
      Número curto de **5 ou 6 dígitos** fornecido pela operadora para envio/recebimento de SMS corporativos. Não é possível escolher um número específico — é definido pela operadora.
    </Note>

    <Frame caption="Seleção de Short Code para envio">
      <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/ShortCode.png" />
    </Frame>
  </Step>

  <Step title="Definir mensagem da campanha">
    Escolha como definir o conteúdo do SMS:

    <Tabs>
      <Tab title="Mensagem do Público" icon="database">
        **Usar mensagem já definida na importação do público.**

        Ideal quando o conteúdo já foi personalizado por contato no arquivo importado.

        Você pode editar ou adicionar a mensagem diretamente no cadastro do público antes do envio.

        <Frame caption="Opção de usar mensagem do público (mailing modelo)">
          <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/mailingmodelo.png" />
        </Frame>
      </Tab>

      <Tab title="Nova Mensagem" icon="pen">
        **Criar mensagem específica para esta campanha.**

        Selecione **"Criar nova mensagem para a campanha"** e digite o texto desejado.

        <Frame caption="Campo para criar nova mensagem na campanha">
          <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/criandoMensagemSMS.png" />
        </Frame>

        <Frame caption="Prévia da mensagem de SMS">
          <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/SMS.jpeg" />
        </Frame>
      </Tab>
    </Tabs>

    <Warning>
      **⚠️ Limite de caracteres do SMS:**

      * Limite padrão: **160 caracteres** por SMS (codificação de 7 bits)
      * **Acentos e símbolos especiais** são tratados como caracteres estendidos e **reduzem o limite**
      * Se o limite for excedido, a mensagem será **fracionada** — gerando cobrança de **mais de 1 SMS**

      **Recomendação:** Use apenas letras simples (sem acentuação) e verifique o contador de caracteres antes de salvar.
    </Warning>
  </Step>

  <Step title="Criar e iniciar">
    Revise todas as configurações e clique em **"Criar"**.

    <Check>
      Se a data/hora de início for igual ao momento atual, a campanha iniciará **imediatamente** após a criação.
    </Check>
  </Step>
</Steps>

***

## Painel de Campanhas

Na tela inicial, consulte campanhas realizadas com:

* 📅 Data/hora de criação, conclusão e início de envio
* 📊 Quantidade de mensagens processadas

Clique nos **três pontinhos** ao lado de cada campanha:

<Frame caption="Painel com campanhas criadas e seus status">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/painelCampanhasCriadas.png" />
</Frame>

<Frame caption="Menu de opções: Estatísticas e Download">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/Menu3pontinhos.png" />
</Frame>

***

## Estatísticas da Campanha

<Columns>
  <Column>
    **📤 Informações de envio**

    * Total de contatos
    * SMS enviados com sucesso
    * SMS pendentes
    * Falhas no disparo

    **📈 Retorno por período**

    Respostas/interações por hora. Considera todos os retornos do público engajado, independente do canal.
  </Column>

  <Column>
    **🎯 Retorno por evento**

    Eventos registrados por atendentes e chatbots para o público engajado. Monitora efetividade de ações específicas.
  </Column>
</Columns>

<Frame caption="Tela de estatísticas da campanha de SMS">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/estatistica.png" />
</Frame>

***

## Relatório CSV (Download)

Exporte o relatório completo em **formato Excel (.csv)** pela opção **Download** no painel:

| Campo                   | Descrição                                  |
| ----------------------- | ------------------------------------------ |
| **NomePessoa**          | Nome do destinatário                       |
| **CpfCnpj**             | Documento do cliente (CPF ou CNPJ)         |
| **CodPessoaCliente**    | Código identificador interno               |
| **DDDTelefone**         | DDD do número de destino                   |
| **NumeroTelefone**      | Número completo de destino                 |
| **EnderecoEmail**       | E-mail vinculado (quando aplicável)        |
| **DataHoraSolicitacao** | Data/hora da solicitação de envio          |
| **DataHoraEnvio**       | Data/hora do processamento pela plataforma |
| **Mensagem**            | Conteúdo do SMS enviado                    |
| **SituacaoEntrega**     | Status: enviado, entregue, falha, etc.     |
| **QtdMensagens**        | Quantidade de SMS gerados por contato      |

<Frame caption="Exemplo de planilha CSV exportada da campanha">
  <img src="https://robbublob.blob.core.windows.net/docs/invenio-center/campanhaSMS/planilha2.png" />
</Frame>

<Note>
  **Relatórios disponíveis na plataforma:**

  * **Relatório Envio SMS:** Detalhes de cada mensagem (envio, entrega, desempenho)
  * **Campanhas Realizadas:** Filtro por período e canal (incluindo SMS)

  Consulte: [Relatórios no Invenio Center](https://docs.robbu.global/docs/center/relatorios)
</Note>

***

## Links Relacionados

<CardGroup cols={2}>
  <Card title="Importação de Público" icon="users" href="https://docs.robbu.global/docs/center/publico-importacao">
    Cadastrar público para campanhas
  </Card>

  <Card title="Relatórios" icon="chart-line" href="https://docs.robbu.global/docs/center/relatorios">
    Relatório Envio SMS e Campanhas
  </Card>

  <Card title="Canais de Atendimento" icon="comments" href="https://docs.robbu.global/docs/center/canais-atendimento">
    Todos os canais disponíveis
  </Card>

  <Card title="Segmentos" icon="layer-group" href="https://docs.robbu.global/docs/center/segmentos">
    Configurar segmentos de envio
  </Card>

  <Card title="Filtro por Canal" icon="filter" href="https://docs.robbu.global/docs/live/filtro-por-canal">
    Filtrar conversas de SMS no Live
  </Card>
</CardGroup>

***

## ⁉️ Perguntas Frequentes (FAQ)

<AccordionGroup>
  <Accordion title="📋 Preciso importar um público antes de criar a campanha?">
    **Sim, obrigatoriamente.** O público deve estar importado antes de iniciar a criação.

    **Caminho:** Invenio Center > Converter > Público > Importar > Selecionar arquivo > Confirmar

    Consulte: [Importação de Público](https://docs.robbu.global/docs/center/publico-importacao)
  </Accordion>

  <Accordion title="⚡ Posso enviar a campanha imediatamente após criar?">
    **Sim!** Para envio imediato, mantenha a data e hora de **Início da Campanha** igual ao momento atual.

    Após clicar em **"Criar"**, o disparo começará automaticamente.
  </Accordion>

  <Accordion title="⏰ Como agendar a campanha para uma data futura?">
    Durante a criação, defina a data e hora desejadas no campo **"Início da Campanha"**.

    **Dica adicional:** Configure uma **"Hora limite"** para que a campanha seja encerrada automaticamente se não concluir antes do horário definido (útil para evitar envios fora do horário comercial).

    **Caminho:** Invenio Center > Converter > Campanhas > SMS > Criar campanha > Início da Campanha
  </Accordion>

  <Accordion title="📟 O que é o Short Code?">
    **Short Code** é um número curto de **5 ou 6 dígitos** usado como remetente do SMS corporativo.

    **Características:**

    * ✅ Fornecido pela operadora de telefonia
    * ✅ Reconhecido pelos destinatários como comunicação empresarial
    * ❌ Não é possível escolher ou personalizar o número
    * ❌ Não é um número de celular convencional

    **Onde configurar:** Invenio Center > Converter > Campanhas > SMS > Criar campanha > Short Code
  </Accordion>

  <Accordion title="⚠️ Como garantir que minha mensagem não seja fracionada?">
    Siga estas regras para manter a mensagem dentro de **1 SMS (160 caracteres)**:

    * ✅ Use apenas **letras sem acentuação** (a, e, i, o, u → sem ã, é, ç, etc.)
    * ✅ Evite **símbolos especiais** (©, ®, €, etc.)
    * ✅ Monitore o **contador de caracteres** durante a criação
    * ❌ Não use emojis — são tratados como caracteres estendidos

    **Impacto do fracionamento:** Cada fragmento conta como 1 SMS, gerando cobrança múltipla por contato. O campo `QtdMensagens` no relatório CSV indica quantos SMS foram gerados por contato.
  </Accordion>

  <Accordion title="👤 O que é a opção 'Contatos em Atendimento'?">
    Esta opção **exclui do disparo** contatos que estão em atendimento ativo.

    **Duas configurações disponíveis:**

    * **Em atendimento ativo:** Exclui contatos com conversa aberta no momento do disparo
    * **Interação recente:** Exclui contatos atendidos dentro do intervalo configurado (ex: últimas 2 horas)

    **Por que usar:** Evita comunicação duplicada e mensagens desnecessárias para clientes já assistidos.
  </Accordion>

  <Accordion title="📝 Qual a diferença entre 'Mensagem do Público' e 'Nova Mensagem'?">
    | Opção                   | Quando usar                                                         |
    | ----------------------- | ------------------------------------------------------------------- |
    | **Mensagem do Público** | O arquivo importado já possui o conteúdo personalizado por contato  |
    | **Nova Mensagem**       | Você quer definir um texto único para todos os contatos da campanha |

    **Recomendação:** Use **Mensagem do Público** quando precisar personalizar o texto por contato (ex: nome, valor de cobrança).
  </Accordion>

  <Accordion title="📊 Como acompanhar o desempenho em tempo real?">
    **Caminho:** Invenio Center > Converter > Campanhas > SMS > Três pontinhos > Estatísticas

    **Métricas disponíveis:**

    * 📤 **Enviados / Pendentes / Falhas**
    * 📈 **Retorno por período** (respostas por hora)
    * 🎯 **Retorno por evento** (ações de atendentes e chatbots)
  </Accordion>

  <Accordion title="📥 O que contém o relatório CSV da campanha?">
    O relatório exportado inclui dados detalhados por contato:

    **Dados de contato:** Nome, CPF/CNPJ, DDD e telefone
    **Dados de envio:** Data/hora de solicitação e envio
    **Desempenho:** Status de entrega e quantidade de SMS gerados por contato

    **Como exportar:**
    Invenio Center > Converter > Campanhas > SMS > Três pontinhos > Download

    Também disponível o relatório **"Campanhas Realizadas"** com filtro por período e canal.
  </Accordion>

  <Accordion title="📉 Por que a campanha pode ter falhas de entrega?">
    **Causas mais comuns:**

    * 📵 **Número inválido ou desconectado:** Telefone fora de área ou desligado
    * 🔢 **Short code bloqueado:** Operadora bloqueou o envio para determinados números
    * 📝 **Mensagem fracionada:** Caracteres especiais causaram fragmentação acima do limite
    * 📄 **Dados incorretos no público:** DDD ou número errado no arquivo importado

    **Como verificar:** Coluna `SituacaoEntrega` no relatório CSV exportado.
  </Accordion>
</AccordionGroup>