Gatilhos
Gatilhos e Notificações – Visão Geral
Os gatilhos requerem fontes de dados configuradas, as quais são preparadas pela equipe de desenvolvimento conforme necessidades específicas. As notificações por e-mail podem ser enviadas tanto internamente quanto externamente, utilizando configurações SMTP flexíveis.
Eventos: acionam ações imediatas (por exemplo, criação de uma Ordem de Serviço).
Jobs: executam periodicamente, ideais para tarefas programadas (por exemplo, alertas de expiração de contrato).
As fontes de dados padrão estão sendo carregadas, permitindo que inicie os testes e identifique possíveis requisitos adicionais.
Tópicos Principais
1. Configuração de Fonte de Dados
Foram realizadas mudanças recentes para permitir filtragem em movimentações de cartões.
A equipe de desenvolvimento precisa saber quais dados são necessários para os alertas (ex.: e-mails, responsáveis, status).
Fontes padrão sendo carregadas incluem: OS, CRM, Propostas.
Deve testar com as fontes disponíveis e relatar dados ausentes ou necessidades de novos filtros.
Configuração de Notificação por E-mail
As configurações SMTP podem ser personalizadas para diferentes departamentos (Comercial, Execução, Financeiro).
Opções flexíveis de destinatários:
E-mails fixos
Gerentes de contrato
Chefes de unidade de negócio
O corpo do e-mail suporta variáveis dinâmicas (ex.: ID do pedido, nome do produto).
Pode ser usado para comunicações internas e externas, incluindo pesquisas com clientes.
Tipos de Gatilhos: Eventos x Jobs
Evento
Acionado por ações imediatas
Criação de uma Ordem de Serviço
Job
Executado periodicamente
Alerta de expiração de contrato
Ambos utilizam a mesma configuração de e-mail, mas Jobs exigem fontes de dados específicas
para seu funcionamento.
Integração via Web Hook
Disponível para integração com sistemas externos, embora não necessária no caso atual.
Pode ser usada para chamadas automáticas a outros sistemas, como metrologia ou monitoramento de contratos.
Para criar um novo gatilho, clique no botão 
localizado no topo do grid.
Com o botão 
esta ação serve para sincronizar as novas entidades disponibilizadas no cadastro de gatilhos. É necessário executá-la antes do primeiro uso da funcionalidade.
Com o botão 
"Expandir agrupamentos", permite aos usuários acessar e ver uma lista completa de todas as entradas ou registros dentro de um determinado contexto ou funcionalidade do sistema. O campo de 
pesquisar permite localizar facilmente o objetivo desejado, tornando o processo mais completo e fácil de seguir. Ao clicar no botão 
"Exportar todos os dados", todas as informações serão exportadas para uma planilha do Excel. Com o botão 
"Seletor de Colunas", a função principal deste botão é permitir que os usuários personalizem a visualização de dados, selecionando quais colunas devem ser exibidas ou ocultadas. O botão "Atualizar dados" 
ao clicar nesse botão, o sistema realizará uma atualização dos dados conforme as configurações e parâmetros estabelecidos, garantindo que as informações exibidas estejam sempre atualizadas e precisas. Utilize o botão 
"Expandir / Esconder Menu" para alternar entre a visualização completa e compacta do menu, facilitando a navegação pelo sistema. Ao expandir o menu, você tem acesso a todas as opções e funcionalidades disponíveis, enquanto ao esconder, você libera mais espaço na tela para focar nas informações ou tarefas em andamento. Utilizando o botão 
"Troca de módulo" permite alternar rapidamente entre diferentes módulos do sistema sem precisar sair ou reiniciar a sessão. Ao clicar nele, será exibida uma lista de módulos disponíveis para o seu perfil de acesso. Basta selecionar o módulo desejado, e o sistema carregará a interface e funcionalidades correspondentes.
O popup abaixo será exibido com o formulário para preenchimento.
Emails
Nome de Exibição do Remetente: opcional. Serve como máscara para o nome do remetente padrão da Solução 360º
Responder Para: opcional. Serve para configurar um email para ser enviada uma resposta se o destinatários desejar
Responder Para (Nome de Exibição): opcional. Serve como máscara para o email do campo Responder Para
Para preencher os destinatários, assunto e corpo do email, clique no botão 
. O popup abaixo será aberto.
No Assunto e Corpo, é possível adicionar informações do registro que ocorreu o evento, essas informações podem ser conferidas clicando no botão "Propriedades disponíveis". Para que a propriedade seja corretamente preenchida no email, é necessário que ela seja colocada da mesma forma que é exibida {NomePropriedade}
Webhooks
URL: Obrigatório
Token: opcional. Serve para os casos em que o endpoint necessita de um Authorization
Algoritmo de Criptografia: obrigatório, padrão Nenhum. Se escolhido SHA256, o corpo da requisição será criptografado e enviado como header
s360-webhook-signatureSecret: opcional. Serve como chave para realizar a criptografia do corpo da requisição. Disponível apenas se o Algoritmo de Criptografia for SHA256
Para configurar os headers da requisição, clique no botão 
. O popup abaixo será aberto, onde é possível adicionar os headers da requisição, bastando preencher a chave (Key) e o valor (Value) do header.
Exemplo do corpo enviado na requisição
{
"CreatedOn": "2024-01-16T15:13:03.8660981Z",
"EntityType": "UnidadeMedida",
"EventType": "EntityInsertedEvent`1",
"Entity": {
"Produtos": [],
"Indicadores": [],
"Codigo": "dm3",
"Nome": "decímetro cúbico",
"InicioValidade": "2024-01-16T15:13:03.8659105Z",
"TerminoValidade": "9999-12-31T23:59:59.9999999",
"Ativo": true,
"CreationTime": "2024-01-16T15:13:03.8665056Z",
"CreatorUserId": 1,
"LastModificationTime": "2024-01-16T15:13:03.8665056Z",
"LastModifierUserId": 1,
"DomainEvents": [
{
"ChangeType": 1,
"EntityType": "UnidadeMedida",
"CreatedOn": "2024-01-16T15:13:03.8660981Z",
"EventType": "EntityInsertedEvent`1"
}
],
"RowVersion": "AAAAAAAXEk8=",
"PropriedadesAdicionais": {},
"Id": 19
}
}Last updated