Mensageria

Visão geral

A Mensageria permite configurar comunicações periódicas com clientes a partir de eventos do sistema. Hoje o envio é feito por e-mail, com corpo e anexo personalizáveis em HTML.

O primeiro evento disponível é Atualização das demandas (Ordens de Serviço) dos clientes (LISTA_OS): para cada cliente destinatário, o sistema monta um relatório com as ordens de serviço daquele cliente e envia o e-mail com o conteúdo configurado.

Também está disponível o evento Carta de despacho do processo integrado ao INPI (CARTA_DESPACHO): o modelo de e-mail é configurado na mensageria, mas o envio é feito diretamente na Ordem de Serviço, quando chega uma atualização da RPI com aquele despacho.

O evento Colidências de marcas monitoradas (COLIDENCIA_MARCAS) segue o mesmo padrão da carta de despacho: o modelo é configurado aqui e o envio é feito na tela de Colidências, após a conferência das marcas.

Os destinatários podem ser cadastrados na própria mensageria ou, com a opção Envio geral, coincidir com os contatos de mensageria do cadastro do cliente.

Acesse em Administrativo → Mensageria. A listagem aceita pesquisa pelo título.

Como isso ajuda o seu negócio?

• Comunicação recorrente com clientes sobre o andamento das demandas.
• Relatório personalizado por cliente, com layout em HTML e PDF opcional.
• Controle de periodicidade com avisos na listagem quando o envio está próximo ou em atraso.
• Rastreabilidade do histórico de envios por participante.

Fluxo de configuração

A configuração segue uma ordem simples. Cada etapa depende da anterior.

Como chegar na tela e criar uma mensageria

1. Criar a mensageria (aba Cadastro)

Clique em Novo na listagem e preencha:

Campo	Descrição
Título	Nome interno para identificar a mensageria na listagem.
Ativo	Define se a mensageria entra no cálculo de avisos de periodicidade.
Evento	Gatilho dos dados. Opções: atualização das OS dos clientes, carta de despacho do INPI ou colidências de marcas.
Tipo de envio	Hoje: e-mail.
Filtro	Obrigatório conforme o evento (veja abaixo).
Periodicidade (dias)	Intervalo esperado entre envios, usado nos avisos da tela principal.
Última execução	Data do último envio realizado (opcional). Base para calcular a próxima execução.
Envio geral (para todos os participantes/clientes)	Desligado (padrão): os destinatários são os cadastrados na aba Participantes. Ligado: o sistema usa os contatos de mensageria dos clientes que coincidem com o evento e o filtro desta mensageria.

Filtro por evento:

• LISTA_OS — opcional. Formato grupo=<id> para restringir as OS a um grupo (ex.: grupo=3).
• CARTA_DESPACHO — obrigatório. Formato secao=<marca|patente|desenho>;despacho=<código> (ex.: secao=marca;despacho=IPAS423).
• COLIDENCIA_MARCAS — não utiliza filtro. A RPI é definida na tela de colidências no momento do envio.

Salve o cadastro. Evento e tipo de envio não podem ser alterados depois — para mudar, crie um novo registro.

A opção Envio geral também não pode ser ligada ou desligada enquanto existirem participantes cadastrados na aba Participantes. Remova-os (ou use Excluir participantes) antes de trocar a opção.

2. Montar a mensagem (aba Mensagem)

Na mesma tela, configure o conteúdo do e-mail:

• Assunto — linha de assunto do e-mail. Se ficar em branco, o sistema usa o título da mensageria.
• Emails em cópia — opcional. Um ou mais e-mails separados por ponto e vírgula (;), enviados em CC.
• Mensagem — corpo do e-mail em HTML. Use variáveis entre chaves { } (veja abaixo).
• Anexo — HTML opcional que será convertido em PDF e anexado ao e-mail.

O Editor ampliado fica disponível depois de selecionar o evento. Nele você edita mensagem e anexo lado a lado e consulta a lista de variáveis do evento, com botões para copiar os trechos.

Acessar a aba Mensagem, usar o editor ampliado e entender as tags

3. Destinatários (aba Participantes)

Com a mensageria salva, a aba Participantes é liberada. O que aparece nela depende da opção Envio geral.

Envio geral desligado (padrão) — cadastre os destinatários nesta aba:

1. Clique em Novo Participante.
2. Selecione o cliente (obrigatório para os eventos de OS, carta de despacho e colidências).
3. Informe contato, e-mail e telefone.
4. Ao escolher o cliente, contato, e-mail e telefone podem ser preenchidos automaticamente a partir do cadastro.

O e-mail é obrigatório para envio. É possível informar mais de um endereço separando por ;.

Se houver participantes na lista, o botão Excluir participantes remove todos de uma vez (com confirmação). Não é possível cadastrar ou editar destinatários nesta aba enquanto Envio geral estiver ligado.

Envio geral ligado — a lista mostra os contatos de mensageria dos clientes que coincidem com esta mensageria. Não é possível incluir, editar ou excluir linhas aqui; o cadastro fica em Cadastros → Clientes → aba Contatos.

Um contato coincide quando:

• está marcado como Mensageria;
• o cliente está ativo;
• não tem evento informado ou tem o mesmo evento desta mensageria;
• o filtro do contato está vazio ou é um subconjunto do filtro da mensageria (ex.: contato com secao=marca coincide com a mensageria secao=marca;despacho=IPAS423).

Sem evento no contato, ele entra em todos os eventos da empresa quando a opção Envio geral estiver ligada.

A lista da aba aceita pesquisa por contato ou razão social.

4. Validar e enviar

Antes do envio em massa (evento LISTA_OS), use por linha da aba Participantes:

• Prévia do e-mail — visualiza destinatário, assunto, corpo renderizado e anexo PDF.
• Histórico de envios — consulta tentativas anteriores e eventuais erros.
• Enviar e-mail — envia só para aquele destinatário (contatos do mesmo cliente naquela linha vão no mesmo e-mail).

O botão Enviar no rodapé do cadastro dispara o lote para todos os destinatários. O processamento ocorre em segundo plano: a tela informa que o envio foi colocado na fila e o botão permanece ocupado até terminar. Um e-mail é montado por cliente (vários contatos do mesmo cliente entram no mesmo envio).

O envio é manual. A periodicidade e a última execução servem para os avisos na listagem (mensagerias em atraso ou previstas nos próximos 5 dias), não disparam o e-mail automaticamente.

Carta de despacho: a prévia e o envio não são feitos nesta tela (o botão Enviar não aparece). Configure o modelo aqui; o disparo ocorre em Serviços → Ordens de serviço. Os destinatários seguem a mesma regra da opção Envio geral (contatos coincidentes ou participantes cadastrados). A mensageria usada na OS é a que está ativa com o filtro exato da seção e do código do despacho.

Colidências de marcas: a prévia e o envio não são feitos nesta tela. Configure o modelo aqui; o disparo ocorre em Serviços → Consulta de PI → Colidências, por marca ou em lote. Os destinatários seguem a mesma regra da opção Envio geral. Deve haver apenas uma mensageria ativa deste evento.

Como visualizar a prévia, realizar o envio e ver o histórico de envio

Variáveis no HTML

O corpo e o anexo aceitam placeholders que são substituídos pelos dados reais no momento do envio.

Campo simples:

<p>Olá, {con_contato}.</p>

Coleção (lista repetida):

{ordens_servico.map(el => (
  <p>OS {el.os_numero} — {el.os_status}</p>
))}

Campos principais do evento LISTA_OS:

• Gerais: {con_contato}, {emp_cnpj}, {emp_razao_social}
• Por OS (dentro de ordens_servico.map): número, status, título, cliente, técnico, datas, histórico, documentos, entre outros.
• INPI (quando a empresa tem integração ativa e a OS está vinculada): dados do processo, RPIs e última publicação.

Campos principais do evento CARTA_DESPACHO (uma OS + um despacho):

• Dados da OS, do cliente e da empresa.
• Dados do processo no INPI e da publicação RPI do despacho.
• Prazos gerencial e oficial, quando configurados em Prazos de despachos.

Campos principais do evento COLIDENCIA_MARCAS (uma marca monitorada + as colidências selecionadas):

• Dados da OS, do cliente e da empresa.
• Dados da marca monitorada no INPI (processo, titular, classe, especificação, datas).
• Número da RPI e coleção {colidencias} com processo, nome, score e grau de semelhança de cada marca selecionada.

A lista completa aparece no Editor ampliado, depois de selecionar o evento. Variáveis inválidas ou HTML malformado são rejeitados ao salvar.

Avisos na listagem

Na tela principal, mensagerias ativas exibem notificações no topo da listagem quando:

• a próxima execução (última execução + periodicidade) já passou — aviso vermelho (em atraso);
• a próxima execução está nos próximos 5 dias — aviso em laranja claro (a serem executadas em breve).

Atualize o campo Última execução após realizar os envios para manter o controle em dia.

Notificações de avisos na tela (em atraso e próxima execução)

Regras importantes

• Não é possível excluir uma mensageria que ainda tenha participantes cadastrados na aba — inative o registro ou remova os participantes antes (incluindo Excluir participantes).
• Destinatários dos eventos de OS, carta de despacho e colidências precisam estar vinculados a um cliente.
• O envio só ocorre se houver mensagem configurada e destinatário com e-mail.
• Se o cliente não tiver ordens de serviço, o envio do evento LISTA_OS para aquele cliente falha com mensagem de erro no histórico.
• A carta de despacho exige filtro de seção/despacho e é enviada pela tela de Ordens de Serviço, não pelo botão Enviar da mensageria.
• As colidências de marcas não usam filtro e são enviadas pela tela de Colidências, não pelo botão Enviar da mensageria. Exigem integração INPI e pelo menos uma colidência selecionada na marca revisada.
• Com Envio geral ligado, o cadastro de destinatários avulsos nesta tela fica bloqueado; com participantes avulsos ainda na lista, a opção Envio geral não pode ser alterada.

Próximos passos

Novos eventos e tipos de envio (como WhatsApp) serão adicionados em versões futuras.