Configurar as notificações
Configurar as notificações em um tenant é ativar o serviço de notificações, instalar os tipos de notificação e as automações que os enviam, e selecionar os canais que cada usuário recebe. Os passos abaixo são para o Suporte e o IT da agência. A forma como as pessoas recebem as notificações está em Receber e gerenciar notificações.
Pré-requisitos
- Acesso à Manutenção, incluindo Configuration, Marketplace, Webhooks, Automations e Users.
- Os usuários que devem receber notificações por email têm um endereço de email no seu usuário.
Ativar o serviço de notificações
- Acesse Manutenção → Configuration.
- Abra a aba Notification.
- Ative Use Notifications Service e salve.
Enquanto a opção estiver desativada, o tenant usa as notificações antigas.
Definir o domínio da empresa
O domínio da empresa é o endereço que as notificações usam nos links para o tenant. A Leaves To Approve só é enviada a aprovadores cuja empresa tem domínio.
- Acesse Manutenção → Companies e abra a empresa.
- Abra a aba Outros.
- No grupo Website, selecione o tenant em Domínio e salve.
Repita para todas as empresas cujos usuários recebem notificações.
Instalar os componentes das notificações
Em Manutenção → Marketplace, instale:
- todos os componentes da categoria Notifications: tipos de notificação, templates de email, queries, automações e webhooks;
- o workspace Notification, que acrescenta a aba NOTIFICAÇÃO aos usuários;
- o workspace Notifications, a página que lista todas as notificações;
- o workspace Notification Types.
O Marketplace agrupa os componentes por categoria e depois por módulo. Instale cada um com ⊕. O procedimento completo, incluindo componentes não aprovados, está em Instalar componentes do Marketplace.
Depois da instalação, os tipos de notificação aparecem em Manutenção → Notification Types. Cada um tem um nome e uma descrição por língua, que pode editar. A descrição é o que os usuários veem nas suas preferências.
Verificar os webhooks
As notificações enviadas por um evento começam em um webhook. Em Manutenção → Webhooks, abra cada webhook das notificações e verifique que:
- Active está ativado.
- Event e Document correspondem ao evento que deve enviar a notificação, por exemplo Updated em Leave.
- Automation está ativado e Automation Workflow indica a automação da notificação.
Alguns webhooks têm também Filters, que restringem os eventos que executam a automação. Um filtro combina Business Object Type Name com condições sobre uma Detail Path Expression, uma Condition e um Value, ligadas por And ou Or. Add filter acrescenta uma condição.
Cada campo do formulário do webhook está descrito em Webhooks.
Verificar os agendamentos das automações
As notificações enviadas por agendamento, como Team Birthdays ou Leaves To Approve, só são executadas quando sua automação tem um agendamento ativo. Em Manutenção → Automations, a coluna Scheduler mostra o agendamento de cada automação e Active mostra se a automação é executada. Os agendamentos estão explicados em How automations start.
Definir as preferências dos usuários
Um usuário só recebe um tipo de notificação nos canais selecionados para ele. Enquanto nenhum canal estiver selecionado, o usuário não recebe nada desse tipo.
- Acesse Manutenção → Users e abra o usuário.
- Abra a aba NOTIFICAÇÃO, através de ▾ se ela não estiver visível.
- Selecione Email, Push e Web para cada tipo de notificação.
Definir as preferências de outros usuários exige a role CanManageOthersPreferences, e a própria aba exige NotificationPreferenceWrite. Para as Mentions, ative também Receber notificações dos documentos no usuário.