Maestro - Overview

​

Principais Funcionalidades

• Centralização e unificação de templates em um único ambiente
• Gestão do fluxo de aprovação de envios e templates
• Aplicação de regras de envio personalizadas, via Motor de Regras

​

Canais Compatíveis

• WhatsApp
• E-mail
• SMS
• RCS

​

Como Funciona

• A empresa que gerencia o ambiente
• As assessorias responsáveis pelos envios
• Os motores de validação de regras
• Os brokers de envio

​

Perfis de Uso

• Gerente do ambiente - Empresa administradora e supervisora do ambiente
• Assessorias - Empresa com permissões restritas às campanhas, públicos, segmentos, relatórios e templates da própria empresa.
• Revisora - Empresa responsável pela revisão e aprovação de templates

​

Tela de Login

• Login por e-mail e senha
• Login com SSO (Single Sign-On)

​

SSO (Single Sign-On)

• Microsoft Entra ID (Azure AD).

​

Menu Lateral

​

Perfil: Gerente do Ambiente

​

Perfil: Assessoria

• Dashboard
• Relatórios
• Público
• Segmentos
• Campanhas
• Templates
• Usuários
• Configurações
• Ajuda

​

Perfil: Revisora

• Empresas
• Revisão de templates
• Usuários

​

Público

TIPO_DE_REGISTRO, VALOR_DO_REGISTRO, CANAL, CODIGO_TEMPLATE, CODIGO_TEMPLATE_EXTERNO, SEGMENTO, CPF_CNPJ, COD_CONTRATO, REMETENTE, DATA_HORA_DISPARO, NOME_CLIENTE, NOME_ARQUIVO_ANEXO, OBS1, OBS2, OBS3, OBS4, BROKER_REFERENCE, BROKER, Var1, Var2, Var3

​

Colunas do Template Público

• TIPO_DE_REGISTRO [OBRIGATÓRIO]: Valores possíveis: TELEFONE ou EMAIL.
  • Um contato pode ter múltiplas linhas (um canal por linha).
• VALOR_DO_REGISTRO [OBRIGATÓRIO]:
  • Insira o registro do destinatário, como o seu número de telefone com DDD ou e-mail.
• CANAL [OBRIGATÓRIO]:
  • Canal de envio. Exemplo: whatsapp, sms, email, rcs.
• CODIGO_TEMPLATE [OBRIGATÓRIO]:
  • Código do template que será utilizado.
• CODIGO_TEMPLATE_EXTERNO [OBRIGATÓRIO]:
  • Código externo do template que será utilizado.
• SEGMENTO [OBRIGATÓRIO]:
  • Segmento associado à campanha.
• CPF_CNPJ [OBRIGATÓRIO]:
  • Importante para evitar homônimos e permitir integrações externas.
• COD_CONTRATO [OBRIGATÓRIO]:
  • Identificador interno da empresa (ex: número de contrato).
• REMETENTE [OPCIONAL]:
  • Número ou identificador do remetente.
• DATA_HORA_DISPARO [OPCIONAL]:
  • Data e hora para envio da mensagem.
• NOME_CLIENTE [OPCIONAL]:
  • Recomendado para facilitar localização e interação.
• NOME_ARQUIVO_ANEXO [OPCIONAL]:
  • Nome do arquivo de anexo.

​

Campos de Observação

• OBS1, OBS2, OBS3, OBS4 [OPCIONAIS]

• são armazenados no Maestro
• podem ser utilizados em relatórios
• não interferem na validação ou envio das campanhas

​

Campo de Referência para o Provedor

• BROKER_REFERENCE [OPCIONAL]

• é armazenado no Maestro
• pode ser enviado ao provedor no momento do disparo (quando suportado)

⚠️ Não confunda BROKER_REFERENCE com a coluna BROKER. BROKER_REFERENCE é uma referência externa livre, repassada ao provedor; BROKER define qual provedor fará o disparo.

​

Definir o Provedor no Disparo (BROKER)

• BROKER [OPCIONAL — apenas SMS e RCS]

• Vazio → mantém o roteamento por segmento atual, conforme configurado na Integração com Provedores.
• Preenchido e válido → força a utilização do provedor indicado.
• Nome inválido → o arquivo é rejeitado.
• Canais diferentes de SMS e RCS ignoram a coluna.

​

Variáveis do Template

...;OBS1;OBS2;OBS3;OBS4;BROKER_REFERENCE;BROKER;Var1;Var2;Var3;Var4

{{Var1}}
{{Var2}}
{{Var3}}

​

Coluna SMS_FLASH

• Um contato pode ser indicado para receber um SMS do tipo flash (Mensagem no formato de pop-up).

⚠️ Atenção: O recurso de SMS Flash também deve ser contratado/habilitado no provedor da Pontal, não apenas habilitado no Maestro.

​

Observações importantes

• As colunas OBS1 a OBS4 são apenas informativas
• O campo BROKER_REFERENCE é opcional
• A coluna BROKER é opcional e vale apenas para SMS e RCS
• Todas as colunas após BROKER são tratadas como variáveis dinâmicas

​

Código do Template Externo (CODIGO_TEMPLATE_EXTERNO)

​

Como funciona

• Representa um identificador externo do template
• Pode ser utilizado como alternativa ao CODIGO_TEMPLATE
• O sistema prioriza o código externo quando informado

​

Regras

• Pelo menos um dos campos deve ser informado:
  • CODIGO_TEMPLATE
  • CODIGO_TEMPLATE_EXTERNO
• Se ambos estiverem vazios → erro
• Se o código externo não for encontrado → procura pelo código template do Maestro
• Se nenhum for encontrado → erro

​

Campanhas

​

Campanhas WhatsApp

{{Var1}}
{{Var2}}
{{Var3}}
...

​

Campanhas Email ou SMS

{{Var1}}
{{Var2}}
{{Var3}}
...

​

Segmentos

• Organizar os assuntos, vinculando os contatos ao grupo de envio correto
• Restringir o acesso das assessorias apenas aos segmentos atribuídos

• Visualizar os segmentos já cadastrados
• Criar novos segmentos
• Editar ou remover segmentos existentes

Ao criar um Segmento, a Gerente do Ambiente pode incluir as assessorias que terão acesso à este segmento no dropdown “Empresas”

​

Relatórios

• Campanhas
• Status de Template
  

​

Filtros Disponíveis

• Template
• Criado em
• Empresas
• Segmentos

​

Templates

• WhatsApp
• E-mail
• SMS
• RCS

• Criar novos templates
• Consultar o status de todos os templates criados
• Acompanhar o fluxo de aprovação (quando aplicável)
• Duplicar templates ativos ou expirados

Os templates são categorizados de acordo com o tipo de canal de disparo.

• Em criação: O template está em desenvolvimento e ainda não foi submetido para revisão. Este status existe apenas no canal Email.
• Em revisão: O template já foi submetido para revisão da Gerente do Ambiente ou da empresa Revisora e está aguardando análise. Templates em reaprovação também aparecem com este status, sem destaque especial.
• Aprovado: O template foi aprovado por um revisor, mas ainda não foi publicado no broker
• Publicado: O template foi aprovado por um revisor e já está disponível para uso no broker
• Rejeitado: O template foi reprovado por um revisor. O motivo fica disponível para consulta.
• Expirado: O template expirou devido à configuração de expiração de templates
• Rejeitado por Meta: O template foi aprovado pelo revisor, mas rejeitado pela Meta. Este status existe apenas no canal Whatsapp.

​

Ciclo de vida dos templates

​

Alertas de vencimento

1. Vence amanhã
2. Expirado há X dias — exclusão ocorrerá em 30 dias
3. Em reaprovação

​

Configurações de templates

• Quantidade de dias para expiração: define após quantos dias o template é considerado expirado. Templates expirados ficam visíveis mas indisponíveis para novos disparos até serem atualizados ou revalidados.
• Quantidade de dias para alertar: define com quantos dias de antecedência os alertas visuais e as notificações por e-mail são disparados.

​

Duplicar template

No caso de importação, caso o arquivo não corresponda ao padrão esperado, a plataforma irá retornar um arquivo com o motivo do erro.

​

Construtor de Templates

​

WhatsApp

⚠️ O nome do template não pode conter acentos ou espaços.

• Estrutura do Template

• Texto (até 60 caracteres), ou
• Mídia: imagem, vídeo ou documento.

⚠️ O cabeçalho do template pode conter somente uma única variável

• Texto com até 1.024 caracteres
• Emojis
• Variáveis: {{Var1}}, {{Var2}}, etc. (clicando no botão “Variável”)

⚠️ Não misture múltiplos formatos em uma única palavra (negrito + itálico, por exemplo).

• Resposta rápida Retornam o texto do botão como resposta.
  • Máximo de 3 botões por template
  • Máximo de 20 caracteres por botão
  • Não aceita emojis, variáveis ou formatação
• Botão de ação
  • Visitar website
  • Ligar através do WhatsApp
  • Ligar para número de telefone
  • Copiar código

Para URL dinâmica, você deve fornecer um exemplo de preenchimento.

⚠️ Você só pode usar um tipo de botão por template.

​

E-mail

• Estrutura do Construtor
  • Configurações Gerais Nesta aba, você poderá:
    • Definir o nome do template;
    • Especificar o assunto do e-mail;
    • Informar um e-mail para teste, que será usado no envio do preview do template.

• Escolha a divisão do layout em colunas (de 1 até 4 colunas);
• Combine diferentes seções com divisões variadas de colunas, conforme a necessidade do conteúdo.

• Negrito, itálico, sublinhado, links e alinhamentos;
• Cores de fundo e de texto;
• Bordas arredondadas, padding e tamanho da fonte.

• Upload da imagem;
• Descrição e link;
• Cor de fundo, largura, padding, alinhamento e bordas.

• Cor de fundo do corpo e conteúdo;
• Fonte e tamanho;
• Cores de texto e links;
• Padding do corpo do e-mail.

• Criação via HTML

• Um campo para colar ou escrever seu código HTML personalizado;
• Um preview visual ao lado direito com a renderização do seu template.

As Configurações Gerais e Tags continuam disponíveis nesta modalidade.

​

Revisão de Templates

• Visualizar todas as templates criadas
• Filtrar templates por canal e por status
• Exportar a lista de templates no formato CSV

Essa funcionalidade permite acompanhar o processo de aprovação e manter controle sobre o ciclo de vida de cada template.

​

Empresas

• Visualizar a lista de empresas cadastradas
• A Gerente do Ambiente pode criar novas empresas

Essa funcionalidade centraliza a gestão de empresas que farão parte das estratégias de comunicação dentro do Maestro.

​

Usuários

​

Perfis de Usuário

​

Administrador

• Criar, editar e excluir usuários da empresa
• Criar públicos e disparar campanhas
• Criar, editar e excluir templates
• Gerar relatórios
• Gerenciar configurações da empresa

​

Colaborador

​

Visualizador

• Visualizar templates cadastrados

• Criar públicos
• Disparar campanhas
• Criar, editar ou excluir templates
• Gerar relatórios
• Gerenciar usuários da empresa
• Gerenciar configurações da empresa

​

Configurações

​

Ambiente

​

Configurações de Templates

A configuração de templates permite definir regras relacionadas ao uso e validade dos modelos disponíveis no sistema. É possível estabelecer um tempo de expiração para os templates, garantindo que conteúdos desatualizados não sejam utilizados. Para isso, defina o período de validade (em dias), após o qual o template será considerado expirado. Templates expirados ainda poderão ser visualizados, mas não estarão disponíveis para novas utilizações até que sejam atualizados ou revalidados.

⚠️ Atenção: o sincronismo de expiração de todos os templates ocorre uma vez ao dia, durante o período noturno.

​

Empresa

​

Autenticação

• Permite definir como os usuários acessam o sistema.
• Suporte a Single Sign-On (SSO) via Azure AD.
• Necessário informar o ID da aplicação no Azure Active Directory.
• Usuários podem acessar o Maestro com suas credenciais corporativas, sem criar novas senhas.
  

​

SFTP

​

Token de Integração

⚠️ Atenção: Ao clicar em “Renovar token”, o token anterior será invalidado.

​

Regras

​

Integração com provedores