Um workspace do Notifuse guarda seus contatos, as listas em que eles se inscrevem e os templates que você escreve. Você envia para eles de uma de três formas: um broadcast, uma notificação transacional ou uma automação. Cada email enviado fica registrado no histórico de mensagens, e um provedor de email que você conecta faz a entrega propriamente dita.
Workspace
Um workspace é um tenant isolado. Ele tem seu próprio banco de dados, suas próprias integrações, seus próprios membros e suas próprias configurações.
Use um workspace por produto, marca ou cliente. Uma instalação auto-hospedada pode ter três sem licença, e cada plano do Notifuse Cloud inclui uma quantidade própria.
Veja Workspaces.
Contatos
Um contato é uma pessoa para quem você pode enviar email. O endereço de email identifica o contato e é o único campo obrigatório.
Um contato também pode ter um external_id, como o ID do usuário no seu app. Ele é opcional e não é único, então dois contatos podem compartilhar o mesmo.
A importação de contatos e o envio de uma notificação transacional identificam os contatos pelo endereço de email: o contato é criado se ainda não existir e atualizado se já existir.
Veja Contatos.
Listas e status de inscrição
Uma lista é um grupo de contatos que se inscreveram em algo, como uma newsletter ou novidades do produto. Uma lista pública aparece na central de notificações, onde os próprios contatos podem se inscrever nela. Uma lista privada só recebe os contatos que o workspace adiciona. Os dois tipos podem exigir confirmação dupla, com um template de confirmação próprio.
Cada contato tem um status em cada lista de que faz parte:
| Status | O que significa |
|---|---|
| Ativo | Inscrito. Os broadcasts para a lista chegam a esse contato. |
| Pendente | Aguardando a confirmação dupla. Não recebe emails até confirmar. |
| Não inscrito | Cancelou a inscrição. Fica fora dos broadcasts, a menos que um broadcast seja configurado para incluí-lo. |
| Retornado | O endereço gerou uma rejeição. Nunca recebe emails. |
| Reclamado | O contato marcou um email como spam. Nunca recebe emails. |
No console, as listas ficam na página Contatos, na coluna da esquerda.
Veja Listas.
Segmentos
Um segmento é um conjunto de contatos que atendem a regras. As regras se combinam com AND e OR e podem considerar campos do contato, inscrições em listas, a atividade na timeline do contato, eventos personalizados e metas.
Os segmentos se atualizam quase em tempo real. Quando algo é registrado na timeline de um contato, o Notifuse coloca esse contato na fila, e uma tarefa em segundo plano recalcula os segmentos dele. Por padrão, a tarefa roda a cada 30 segundos.
Uma regra com data relativa, como “abriu um email nos últimos 30 dias”, muda com o passar do tempo mesmo quando nada acontece com o contato. Uma tarefa em segundo plano separada recalcula esses segmentos.
Veja Segmentos.
Templates
Um template é o conteúdo de um email: assunto, remetente e corpo. O corpo é MJML com Liquid para a personalização, como {{ contact.first_name }}. Os templates têm versões, e cada email enviado registra a versão que usou.
Você escreve um template em um de dois editores, escolhido na criação e fixo depois disso:
- Visual: blocos que você arrasta e solta.
- Código (MJML): você mesmo escreve o MJML.
Cada template tem uma categoria, como marketing, transacional, boas-vindas ou opt-in.
Veja Templates.
Três formas de enviar
Broadcasts
Um broadcast envia um template para uma lista, uma única vez, agora ou em um horário agendado.
Ele precisa de exatamente uma lista. Você pode restringir o público com segmentos: o broadcast vai então para os membros da lista que estão em pelo menos um dos segmentos. Por isso, vários segmentos somam públicos em vez de restringi-los ainda mais.
Contatos retornados e reclamados sempre ficam de fora, assim como os contatos pendentes de uma lista com confirmação dupla. Os contatos não inscritos também ficam de fora, a menos que você desative Excluir destinatários que cancelaram a inscrição para um aviso que todos os membros precisam receber.
Os broadcasts passam pelo provedor de marketing do workspace. Veja Broadcasts.
Notificações transacionais
Uma notificação transacional é um email que seu app dispara para uma pessoa: uma redefinição de senha, uma confirmação de pedido, um convite. Você a cria no console em Transacional, dá a ela um ID e um template e depois a envia do seu código com POST /api/transactional.send.
Cada requisição indica um contato. O Notifuse cria ou atualiza esse contato e depois envia.
As notificações transacionais passam pelo provedor transacional do workspace. Veja API transacional.
Automações
Uma automação é um fluxo em que um contato entra quando um evento chega à timeline dele. Entre os gatilhos estão um contato criado ou atualizado, uma inscrição ou um cancelamento de inscrição em lista, a entrada ou saída de um segmento, um email aberto ou clicado e um evento personalizado que seu app envia.
O fluxo é formado por nós: atrasos, emails, ramificações, filtros, testes A/B, webhooks e a adição a uma lista ou remoção dela. Um gatilho pode disparar uma vez por contato ou toda vez que o evento acontecer.
Os emails de automação passam pelo provedor de marketing do workspace. Veja Automações.
Qual usar?
| Você quer | Use |
|---|---|
| Enviar uma newsletter ou um anúncio para uma lista | Broadcast |
| Enviar email para uma pessoa por causa de algo que ela fez no seu app, como redefinir a senha | Notificação transacional |
| Enviar uma sequência que começa sozinha, como uma série de boas-vindas ou um email de reconquista | Automação |
Histórico de mensagens e Logs
Cada email que o Notifuse envia gera uma linha no histórico de mensagens. A linha aponta para o que fez o envio (um broadcast, uma automação ou uma notificação transacional), para a lista quando há uma e para a versão do template.
A linha também registra quando o email foi entregue, aberto e clicado, e se ele gerou uma rejeição, uma reclamação ou um cancelamento de inscrição.
Você consulta o histórico de mensagens em Logs, na aba Mensagens. Veja Logs.
Provedores de email e suas duas funções
O Notifuse não entrega os emails por conta própria. Cada workspace conecta um ou mais provedores: SMTP, Amazon SES, Postmark, Mailgun, SendGrid, SparkPost ou Mailjet.
Um workspace tem duas funções de envio, e você atribui um provedor a cada uma:
- Emails de marketing: broadcasts e emails de automação.
- Emails transacionais: notificações enviadas pela API, pelo Zapier ou pelo Supabase.
Um mesmo provedor pode assumir as duas funções. Uma função sem provedor não envia nada. O Mailjet só pode assumir a função transacional.
Você define as funções em Configurações, em Integrações. O início rápido do Cloud e o início rápido auto-hospedado mostram o passo a passo, e cada provedor tem sua própria página, como SMTP e Amazon SES.
