Inscrições em Eventos

As Inscrições em Eventos permitem que você escreva a sua própria mensagem e escolha o que dispara o envio: a criação da conta de um novo funcionário, uma mudança de departamento, um desligamento. O caso de uso típico é abrir um chamado no service desk automaticamente quando o Sincroniza provisiona uma conta.

A diferença em relação às Notificações é o público e o conteúdo:

	Notificações	Inscrições em Eventos
Público	administradores, aprovadores e auditores do Sincroniza	qualquer destino que você configurar (service desk, sistema interno, mailbox de equipe)
Conteúdo	gerado e traduzido pelo produto	escrito por você, no idioma que você quiser
Destino	E-mail e Microsoft Teams	E-mail e Webhook (HTTP POST)
Filtro	por tipo de evento	por tipo de evento e por atributos do funcionário

Acessando a Configuração

1. Acesse Configurações no menu lateral
2. Em Monitoramento, clique em Inscrições em Eventos

Pré-requisito para o canal de e-mail

Inscrições por e-mail só enviam quando o Transporte de E-mail está configurado. Confirme que o selo em Configurações → Transporte de E-mail mostra Pronto — veja Notificações. A própria página avisa quando o transporte não está pronto.

O canal Webhook não depende do transporte de e-mail: cada inscrição carrega a sua própria URL.

Eventos Disponíveis

Todos os eventos publicados hoje pertencem ao ciclo de vida do funcionário:

Evento	Dispara quando
Conta do Funcionário Provisionada	uma conta é criada para o funcionário — uma vez por provedor de identidade
Cargo do Funcionário Alterado	a sincronização detecta mudança de cargo no RH
Departamento do Funcionário Alterado	a sincronização detecta mudança de departamento
Localidade do Funcionário Alterada	a sincronização detecta mudança de localidade
Situação do Funcionário Alterada	a sincronização detecta mudança de situação empregatícia
Funcionário Desligado	um funcionário é desligado
Conta do Funcionário Ativada	uma conta é habilitada
Conta do Funcionário Desativada	uma conta é desabilitada

Criando uma Inscrição

Clique em Nova Inscrição. O formulário é dividido em quatro seções.

1. Informações Básicas

Campo	Regra
Nome	obrigatório, até 100 caracteres
Descrição	opcional, até 500 caracteres
Evento	obrigatório

O evento não pode ser alterado depois

Uma vez salva, a inscrição fica presa ao evento escolhido. Para escutar outro evento, crie uma nova inscrição. Use Duplicar para partir de uma existente.

2. Filtro

O filtro decide quando enviar. Sem condições, toda ocorrência do evento envia uma mensagem.

Os campos disponíveis são os dados que aquele evento publica (veja Placeholders Disponíveis) e as condições são combinadas da esquerda para a direita com E / OU. Os tipos de comparação oferecidos são:

Comparação	Uso
é igual a	valor exato (não diferencia maiúsculas de minúsculas)
não é igual a	exclui um valor
começa com	prefixo
contém	trecho em qualquer posição
é um de	lista de valores aceitos

Exemplos:

• Somente a matriz: OfficeLocation é igual a São Paulo
• Somente três departamentos: Department é um de TI, Financeiro, RH

Conta Provisionada dispara uma vez por provedor

Se você usa mais de um provedor de identidade (Active Directory, Entra ID, Google Workspace), um único novo funcionário gera uma mensagem por provedor. A página oferece o botão Somente Active Directory para adicionar o filtro Authority é igual a ActiveDirectory com um clique.

3. Destino

Escolha o Canal:

Canal de E-mail

1. Adicione os Destinatários — digite o endereço e pressione Enter ou clique em Adicionar
2. Para remover, clique no × ao lado do endereço

Limite de destinatários

Até 50 destinatários por inscrição. Todos ficam no campo Para e enxergam os demais.

Canal Webhook

O Sincroniza faz um HTTP POST com a mensagem renderizada no corpo.

Campo	Regra
URL do webhook	obrigatória, URL absoluta http ou https, até 2000 caracteres
Autenticação	opcional, uma credencial API OAuth 2.0
Tipo de conteúdo	definido pelo formato da mensagem, não editável

Autenticação. Selecione uma credencial cadastrada em Credenciais do tipo API OAuth 2.0. O Sincroniza solicita um token com ela e envia o resultado como Bearer no cabeçalho Authorization. Deixe em Nenhuma se o seu endpoint não exigir autenticação.

Tipo de conteúdo. Deriva do formato escolhido na seção Mensagem:

Formato	Cabeçalho Content-Type
Texto simples	text/plain
HTML	text/html
JSON	application/json

Assunto. Uma requisição HTTP não tem linha de assunto, então o assunto renderizado é enviado no cabeçalho X-Sincroniza-Subject.

Redirecionamentos não são seguidos

Se o seu endpoint responder 301/302, o envio falha em vez de seguir para o novo endereço — o recibo de entrega precisa vir do endereço que você configurou. Configure aqui o endereço final.

Limites técnicos do envio

Tempo limite de 30 segundos por tentativa. Até 3 novas tentativas em caso de falha temporária (5xx, 408, 429); qualquer outro 4xx é tratado como erro definitivo, porque repetir não resolveria URL, credencial ou payload incorretos.

4. Mensagem

Campo	Regra
Formato	Texto simples, HTML ou JSON
Assunto	até 500 caracteres
Corpo	texto livre com placeholders

Corpo com assunto

Uma inscrição com corpo também precisa de um assunto — o assunto é a chave que o service desk usa para rotear o chamado. E uma inscrição sem corpo não envia nada: escreva a mensagem que deve ser entregue.

O botão Usar modelo padrão preenche assunto e corpo com um modelo pronto para o evento escolhido, substituindo o que estiver escrito.

A sua mensagem não é traduzida

O texto que você escreve é enviado exatamente como está, em qualquer idioma. O Sincroniza apenas substitui os placeholders.

Placeholders Disponíveis

Escreva {NomeDoCampo} no assunto ou no corpo e o Sincroniza substitui pelo valor do funcionário. Clique em um placeholder no painel lateral para inseri-lo na posição do cursor, ou digite { para buscar.

Grupo	Campos
Evento (todos os eventos)	EventId, OccurredAt
Funcionário (todos os eventos)	EmployeeId, SourceId, EmployeeNumber, FullName, FirstName, LastName, DisplayName, Email, JobTitle, Department, OfficeLocation, Company, City, State, Country, EmploymentStatus, EmploymentType, HireDate, TerminationDate, ManagerName, ManagerEmail
Campos personalizados (todos os eventos)	CustomField1 … CustomField15
Conta (provisionada, ativada, desativada)	Authority, Username, UserPrincipalName
Alteração (cargo, departamento, localidade, situação)	ChangedField, OldValue, NewValue

Authority contém ActiveDirectory, EntraId ou GoogleWorkspace.

Os nomes diferenciam maiúsculas de minúsculas

{Department} funciona; {department} não. O mesmo vale para os campos do filtro. O Sincroniza recusa o salvamento de um placeholder ou campo desconhecido, informa qual é e sugere a grafia correta — o erro aparece ao salvar, não silenciosamente na hora de enviar.

{Email} costuma estar vazio em Conta Provisionada

O endereço da caixa postal é gravado depois que a conta é criada. Use {UserPrincipalName} para o nome de login. A página exibe esse aviso ao escolher o evento.

Intervalo Mínimo

Ainda não ativo

O campo Intervalo mínimo (minutos) é salvo, mas nenhum intervalo é aplicado até que esse recurso seja liberado. Deixe vazio para nunca aplicar um intervalo.

Gerenciando Inscrições

Ação	Efeito
Interruptor	ativa ou desativa a inscrição sem apagá-la
Editar	altera tudo exceto o evento
Duplicar	cria uma cópia com o sufixo (cópia), pronta para ajustar
Excluir	remove a inscrição

Excluir para o envio imediatamente

Mensagens já na fila continuam sendo entregues. A ação não pode ser desfeita.

Use a busca no topo da página para filtrar as inscrições pelo nome.

Acompanhando os Envios

As mensagens enviadas por inscrições aparecem no histórico de notificações, em Configurações → Notificações → Histórico:

• Aba E-mail: inscrições do canal de e-mail
• Aba Webhook: inscrições do canal webhook, com a URL de destino, o assunto, o status, as tentativas e o erro retornado pelo endpoint

Permissões

Permissão	Concede
EventSubscription.List	ver a lista de inscrições
EventSubscription.Read	ver os detalhes de uma inscrição e o catálogo de eventos
EventSubscription.Create	criar inscrições
EventSubscription.Update	editar e ativar/desativar inscrições
EventSubscription.Delete	excluir inscrições

Configure-as em Usuários.

Solução de Problemas

Problema	Causa Provável	Solução
Inscrição por e-mail não envia	Transporte de e-mail não configurado ou desligado	Verifique Configurações → Transporte de E-mail: o selo deve mostrar Pronto
Nada é enviado, sem erro no histórico	Inscrição sem corpo	Escreva o corpo da mensagem — sem ele nada é enviado
Nada é enviado, sem erro no histórico	Filtro nunca corresponde	Revise as condições; lembre que os nomes dos campos diferenciam maiúsculas de minúsculas
Uma contratação gera várias mensagens	Mais de um provedor de identidade ativo	Adicione o filtro Authority — use o botão Somente Active Directory
Placeholder aparece literal na mensagem	Grafia incorreta	Insira pelo painel de placeholders em vez de digitar
{Email} vazio na mensagem de conta criada	O e-mail é gravado após a criação da conta	Use {UserPrincipalName}
Webhook com status "Falha" e erro de redirecionamento	O endpoint responde 301/302	Configure a URL final; redirecionamentos não são seguidos
Webhook com erro 401/403	Credencial ausente ou sem permissão no destino	Revise a credencial API OAuth 2.0 em Credenciais
Não é possível salvar: campo de filtro inválido	O campo não é publicado por esse evento	Use um campo da tabela de placeholders correspondente ao evento

Próximos Passos

• Notificações - Configure o transporte de e-mail e os alertas administrativos
• Credenciais - Cadastre a credencial API OAuth 2.0 usada pelo canal webhook
• Provisionamento Automático - Entenda quando o evento de conta provisionada dispara
• Desligamento - Entenda quando o evento de desligamento dispara