Esta é uma primeira versão do FAQ geral, escrita a partir do conteúdo já documentado do Maestro. Ela deve ser revisada e expandida pelo time de suporte com base nos chamados mais recorrentes. Dúvidas técnicas específicas de cada integração já têm FAQ própria: Motor de Regras, Direct Message API e Uso de SFTP.
Acesso e login
Esqueci minha senha, como recupero o acesso?
Esqueci minha senha, como recupero o acesso?
Utilize a opção de recuperação de senha na tela de login. Se sua empresa usa apenas SSO, não há senha própria do Maestro — o acesso é feito pelas credenciais corporativas.
O login por SSO não funciona, o que verificar?
O login por SSO não funciona, o que verificar?
Confirme que: (1) o usuário já está previamente cadastrado na tela de Usuários do Maestro — o SSO não cria usuários novos; (2) o ID da aplicação do Microsoft Entra ID (Azure AD) está corretamente configurado em Configurações > Empresa; (3) a URL
https://api.maestro.robbu.global/v1/auth/login/sso/callback está liberada no aplicativo de SSO. Veja Primeiros Passos.Qual a diferença entre perfil de empresa e perfil de usuário?
Qual a diferença entre perfil de empresa e perfil de usuário?
Perfil de empresa (Gerente do Ambiente, Assessoria, Revisora) define o escopo de dados e telas visíveis. Perfil de usuário (Administrador, Colaborador, Visualizador) define o que aquele usuário específico pode fazer dentro da empresa. Veja Perfis de Uso e Empresas e Usuários.
Templates
Por que meu template não aparece na hora de criar uma campanha?
Por que meu template não aparece na hora de criar uma campanha?
Só templates com status Publicado (quando há broker configurado para o canal) ficam disponíveis para novas campanhas. Templates em criação, em revisão, rejeitados ou expirados não aparecem na lista. Veja Templates.
Quanto tempo demora a aprovação de um template?
Quanto tempo demora a aprovação de um template?
Não há um SLA fixo documentado — a aprovação depende da revisão feita pela Gerente do Ambiente ou pela empresa Revisora. Para WhatsApp, após a aprovação interna ainda há o envio para análise da Meta, que pode rejeitar o template mesmo após aprovado internamente.
Posso editar um template já aprovado?
Posso editar um template já aprovado?
O fluxo documentado é duplicar o template (gera um novo código e reinicia o fluxo de aprovação) em vez de editar o original. Veja Templates — Duplicar template.
Campanhas e Direct Message
Qual a diferença entre uma Campanha e a Direct Message API?
Qual a diferença entre uma Campanha e a Direct Message API?
Campanha é um disparo em massa para um público importado. Direct Message é o envio de uma mensagem unitária, via API, fora do ciclo de campanhas — mas usando os mesmos templates, brokers e motor de regras. Veja Campanhas e Direct Message API.
Por que minha campanha não disparou?
Por que minha campanha não disparou?
Veja o passo a passo de diagnóstico em Troubleshooting.
Público e importação
Por que meu arquivo de importação foi rejeitado?
Por que meu arquivo de importação foi rejeitado?
As causas mais comuns são: nome de colunas diferente do esperado,
CODIGO_TEMPLATE e CODIGO_TEMPLATE_EXTERNO ambos vazios, ou segmento inexistente/sem permissão. Veja Público e Troubleshooting.Qual a diferença entre importar Público pela tela e importar Campanha por SFTP?
Qual a diferença entre importar Público pela tela e importar Campanha por SFTP?
São dois fluxos com layouts de arquivo diferentes. A importação em Público > Importar público cria uma base reutilizável em múltiplas campanhas. A importação de campanha via SFTP (
/maestro/campaigns) já dispara a campanha diretamente. Veja Público e Uso de SFTP.Provedores (brokers)
Como saber qual broker está sendo usado em um disparo?
Como saber qual broker está sendo usado em um disparo?
Por padrão, o roteamento segue a configuração de segmento em Configurações > Integração com provedores. Para SMS e RCS, é possível forçar um provedor específico por registro usando a coluna/campo
BROKER. Veja Integração com Provedores.Um segmento pode usar mais de um provedor?
Um segmento pode usar mais de um provedor?
Não. Um segmento só pode estar vinculado a um único provedor por vez (exclusividade). É possível, porém, indicar um provedor diferente pontualmente no momento do disparo (SMS/RCS), via coluna
BROKER.