Pular para o conteúdo principal

​
Motor de Regras

O motor de regras é um mecanismo do Maestro para gerenciar e supervisionar os disparos feitos pelas assessorias. A Gerente do Ambiente pode configurar diversas regras dentro deste motor e essas regras serão verificadas durante campanhas, disparos por API ou upload de campanhas por SFTP.

​
Configuração Inicial

  • O acesso às regras deve ser feito com perfil Gerente do Ambiente em: Configurações > Regras

​
Tipos de regras

Há dois tipos primários de regras:
  • Regras implícitas
    • Estas regras validam conceitos do sistema e não podem ser desativadas
  • Regras customizáveis
    • Cada regra customizável pode ser ativada ou desativada.

​
Regras implícitas

Algumas regras não são exibidas no motor de regras mas rodam como validadores de disparos e campanhas no Maestro:

​
Segmento válido

A assessoria só consegue criar templates, criar campanhas e disparar mensagens em segmentos que possui acesso.

​
Template aprovados

Apenas templates aprovados são válidos para criar campanhas e disparar mensagens. Se houver broker configurado para o canal utilizado, o template deve estar “Publicado”. Se não houver broker configurado, a mensagem não será disparada, mas o template será considerado válido e poderá ser utilizado para integrações externas Templates expirados não ficam disponíveis para uso após a rotina de expiração. Templates vencidos há mais de 5 dias não devem aparecer na lista de seleção.

​
DDD e Telefone

Quando o disparo é efetuado para um telefone (WhatsApp ou SMS):
  • Campanhas devem ter DDD mapeado corretamente.
  • Telefones com formatação inválida serão rejeitados.

​
Regras customizáveis

Essas regras podem ser ativadas ou desativadas

​
Regra de horário

  • Campanhas não podem ser agendadas fora da faixa permitida
  • Disparos não podem acontecer fora da faixa permitida
A configuração pode ser por horário comercial (das 08:00 às 18:00) ou por intervalo de datas e horários específicos

​
Bloqueio por feriado

Em dias de feriado configurados, campanhas e disparos são bloqueados automaticamente. É possível configurar apenas feriados nacionais ou também feriados inseridos manualmente.

​
Bloqueio por listas de restrição

Essa regra funciona tanto como uma lista de restrição para números ou e-mails fornecidos, quanto como um limitador de disparos por DDD ou por quantidade de disparos por contato.
  • Números ou e-mails bloqueados em lista de restrição não serão processados para disparo.
  • Restrições por DDD impedem disparos para contatos dessas regiões fora do horário definido.
⚠️ Contatos duplicados serão rejeitados pelo motor de regras

​
Limite diário de disparos por contrato

Limite a quantidade de mensagens enviadas por dia para cada contrato. Deixe este campo vazio para não aplicar limite de disparos diários.
  • Cada contrato tem um limite diário de disparos.
Se um contato (e-mail ou telefone) estiver vinculado a mais de um contrato:
  • O contrato que ultrapassar o limite será bloqueado.
  • O contrato dentro do limite terá o disparo processado normalmente.

​
Bloqueio por Domínio de Email

Domínios de e-mail podem ser configurados para que todas as tentativas de disparo para estes domínios sejam rejeitadas. Ex: gov.br, bol.com.br, etc.

​
Controle de Erros

Se o percentual de erros no arquivo da campanha ultrapassar o limite configurado, a base inteira é invalidada e nenhum disparo é efetuado.
  • Caso o limite esteja configurado em 0%, nenhuma base será invalidada por esta regra, mesmo ela estando ativa.

​
Como o motor de regras funciona?

​
Campanhas

Ao se criar uma nova campanha, o motor de regras é executado. A criação da campanha será rejeitada caso as seguintes regras forem inválidas:
  • Regra de horário
  • Bloqueio por feriado
  • Controle de erros
Caso as regras acima sejam válidas, a campanha será criada e cada disparo será efetuado. O disparo pode ser bloqueado caso as seguintes regras forem inválidas:
  • Bloqueio por listas de restrição
  • Limite de disparos diários por contato
  • Bloqueio diário
  • Bloqueio por domínio de e-mail

​
API Direct Message

Cada chamada da API Direct Message é considerado um disparo avulso. O disparo será bloqueado caso uma regra seja quebrada. 409 - Conflict 
{
      "message": "Erro na validação do Motor de Regras.",
      "errors": {},
      "record_errors": [],
      "conflicts": [
        "Domínio de e-mail bloqueado na Lista de Restrição",
        "E-mail bloqueado na Lista de Restrição"
      ],
      "requestId": "00-80016a94505f232820c73054f2ee1fa2-12c5228b9f317e12-00"
    }
Para mais informações, consulte a documentação da API Direct Message

​
SFTP

Valida todo o arquivo linha a linha. Caso alguma linha seja invalidada por alguma regra, no arquivo final da importação, criado na pasta /maestro/campaigns/processed, será criado um arquivo {nome original}_EXCEPTIONS.csv com todas as exceções que foram encontradas durante a validação do arquivo importado.
  • Este arquivo contém a cópia da linha original com uma coluna adicional Motivo Falha exibindo o porquê do contato não ter sido processado
Exemplo: 
(Outras colunas...),MotivoFalha
...,Excedido o limite de envios diários para esse contato
...,Número bloqueado na lista de restrição
...,Envio bloqueado fora do horário permitido para este código de área

​
Histórico

No botão histórico de cada regra é possível ver as alterações que cada regra teve com o tempo, incluindo o usuário que realizou a alteração e qual foi a alteração. FAQ
A campanha não será criada, pois o motor valida a regra de horário durante a criação.
Não. Em dias configurados como feriado, os disparos são bloqueados automaticamente.
A base será invalidada e a campanha não seguirá adiante.
Não. Templates expirados ficam indisponíveis após a rotina de expiração e não aparecem na lista de seleção.
O arquivo será rejeitado e não será processado.