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
- SMS
Como Funciona
O Maestro opera como um hub entre:- 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
O Maestro conta com interfaces específicas para diferentes perfis:- 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
A tela de login do Maestro é responsável pelo gerenciamento de acesso e autenticação de usuários, oferecendo dois mecanismos complementares:- Login por e-mail e senha
- Login com SSO (Single Sign-On)
SSO (Single Sign-On)
A autenticação pode ser configurada para permitir login via credenciais corporativas. Atualmente o Maestro possui integração com os seguintes motores de SSO:- Microsoft Entra ID (Azure AD).
https://api.maestro.robbu.global/v1/auth/login/sso/callback em seu aplicativo de SSO para que o retorno possa ser validado
O login SSO valida usuários cadastrados dentro da plataforma Maestro, verifique se o usuário que irá realizar o login por SSO já está cadastrado na tela de usuários.
Você também pode configurar para permitir que usuários acessem a plataforma utilizando apenas o SSO.
Menu Lateral
O menu lateral e superior está disponível em todas as telas do Maestro, oferecendo acesso rápido às principais funcionalidades. As opções exibidas variam de acordo com o perfil da empresa do usuário.Perfil: Gerente do Ambiente
A empresa com perfil de Gerente possui acesso completo às funcionalidades, permitindo a supervisão de todas as atividades dentro do ambiente.Perfil: Assessoria
Empresas com perfil de Assessoria possuem um conjunto de opções reduzido, com permissões limitadas e dados referentes ao seu próprio escopo:- Dashboard
- Relatórios
- Público
- Segmentos
- Campanhas
- Templates
- Usuários
- Configurações
- Ajuda
Perfil: Revisora
Empresas com perfil Revisora visualizam apenas o que é referente à revisão e aprovação de templates.- Empresas
- Revisão de templates
- Usuários
Público
Esta seção permite que você importe contatos para que sejam utilizados em campanhas. Essa importação será utilizada como ponto de partida para campanhas massificada Esse recurso garante maior agilidade na preparação de campanhas e na gestão contínua da base de público. Dessa forma, um mesmo público pode ser utilizado por mais de uma campanha, se necessário.
O layout padrão do arquivo de importação possuí as seguintes colunas:
Colunas do Template
-
TIPO_REGISTRO [OBRIGATÓRIO]: Valores possíveis:
TELEFONEouEMAIL.- Um contato pode ter múltiplas linhas (um canal por linha).
-
VALOR_REGISTRO [OBRIGATÓRIO]:
- Insira o registro do destinatário, como o seu número de telefone com DDD ou e-mail.
-
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).
-
NOME_CLIENTE [OPCIONAL]:
- Recomendado para facilitar localização e interação.
-
PRIORIDADE [OPCIONAL]:
- Defina entre:
BAIXA,MEDIAouALTA - Impacta a ordenação de envio
- Defina entre:
Campanhas
O menu de Campanhas traz as opções de realizar campanhas por canal Whatsapp, E-mail ou SMS
Para criar uma campanha nesta seção, escolha o canal desejado e clique em “Criar campanha”.
Informe um nome descritivo para esta campanha, escolha o segmento e o público importado associado a este segmento (que deve ter sido previamente importado na seção “Público”).
Escolha uma data e hora de início dos disparos.
Em “Fluxo de envio” você pode fracionar os envios por intervalo em minutos e percentual de envios por intervalo.
Campanhas WhatsApp
Em remetente, escolha o número de saída. Os números exibidos aqui são vinculados ao segmento da campanha ou são números que permitem envios de qualquer segmento. Após escolher o número, agora escolha o template de mensagem relacionado ao número de saída. Se houver variáveis no template, preencha-as com o nome das colunas do seu CSV de público:Campanhas Email ou SMS
Selecione o template que será utilizado no envio dos emails ou SMS. Se houver variáveis no template, preencha-as com o nome das colunas do seu CSV de público:Segmentos
Os segmentos têm como propósito:- 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
dropdown “Empresas”
Dashboard
A tela de dashboard está disponível exclusivamente para usuários dos tipos Gerente e Assessoria. Ela exibe informações sobre o número de contatos e permite a visualização e análise de dados através de filtros, incluindo:- Empresa
- Canal
- Segmento
- Data Inicial
- Data Final
Análise de Campanha
Relatórios
Ao acessar a seção de Relatórios, o usuário terá a opção de Criar Relatório a partir dos seguintes modelos:- Campanhas
- Status de Template
Filtros Disponíveis
Na criação dos relatórios, podem ser aplicados os seguintes filtros:- Template
- Criado em
- Empresas
- Segmentos
Templates
Na seção Templates, temos três possibilidades distintas de criação de templates de mensagem:- SMS
- Criar novos templates
- Consultar o status de todos os templates criados
- Acompanhar o fluxo de aprovação (quando aplicável)
Os templates podem ter diversos status, como:
- 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
- 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.
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.
O modelo atualizado do arquivo de importação pode ser encontrado em Importar CSV > Baixar modelo
Construtor de Templates
Escolha a categoria, nome do template e o idioma.
⚠️ 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ávelCorpo (obrigatório) Este é o corpo principal da mensagem. Pode conter:
- 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).As variáveis servem para personalizar a mensagem com dados como nome, endereço, contrato etc. Rodapé (opcional) Texto pequeno e discreto (até 60 caracteres), com cor e tamanho reduzidos. Botões (opcional) Você pode adicionar botões dois tipos:
- 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.Visualize sua mensagem Veja a prévia do seu template no canto superior direito da tela. Finalize o cadastro Clique em “Criar template” e aguarde o fluxo de aprovação.
Padrão: Permite construir e-mails visualmente, sem a necessidade de conhecimento técnico em HTML. Ideal para usuários que buscam praticidade e rapidez.
- 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.
- Configurações Gerais
Nesta aba, você poderá:
- 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.
Texto: Arraste o componente de texto para uma das colunas e clique para editar. Você poderá configurar:
- 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.
Configure o estilo padrão de todo o e-mail:
- 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
Na seção de Revisão de Templates é possível:- Visualizar todas as templates criadas
- Filtrar templates por canal e por status
- Exportar a lista de templates no formato CSV
Apenas a Gerente de Ambiente e as empresas com perfil “Revisora” tem acesso à esta seção.
Nesta seção, pode-se visualizar todos os templates já enviados para revisão e também já aprovados ou reprovados.
Templates com status “Em criação” não são exibidos nesta seção.
Empresas
Na tela Empresas, o usuário pode:- Visualizar a lista de empresas cadastradas
- A Gerente do Ambiente pode criar novas empresas
Usuários
Na seção Usuários, é possível listar e gerenciar todos os usuários cadastrados na plataforma MaestroConfigurações
A seção de Configurações permite gerenciar preferências relacionadas ao ambiente, empresa e templates.
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
As configurações de SFTP e seus conceitos e definições são explicados aqui: Uso de SFTPToken de Integração
Este token é uma credencial única e confidencial que permite a comunicação segura entre sistemas. Ele funciona como uma chave de autenticação para autorizar e validar as requisições realizadas durante a integração com nossa plataforma utilizando nossa API.
⚠️ Atenção: Ao clicar em “Renovar token”, o token anterior será invalidado.