Notificações por e-mail
Para enviar e-mails automáticos ao pagador, a conta precisa de duas coisas: uma conta de e-mail, que define o remetente, e notificações por e-mail, que dizem em qual evento enviar e com qual mensagem. A mensagem é inserida dentro de um template de e-mail.
Conta de e-mail
Onde fica: Automações > E-mails > Contas. O botão Nova Conta de e-mail abre o cadastro.
A conta de e-mail cadastrada pelo painel usa o servidor gerenciado da Kobana, enviando em nome de um domínio próprio da sua empresa. Para isso, você publica no DNS do domínio os registros que a Kobana gera.
Use apenas domínio corporativo próprio. Domínios públicos, como Gmail, Hotmail, Outlook, Yahoo, iCloud, UOL, BOL e Terra, são recusados.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
| Nome identificador da conta | Não | Nome para identificar a conta nas listas do painel |
| Nome do Remetente | Sim | Nome que aparece como remetente do e-mail |
| E-mail do Remetente | Sim | Endereço de envio. Precisa ser do mesmo domínio informado em Domínio |
| Domínio | Sim | Domínio da empresa, por exemplo meudominio.com.br |
| E-mail para Resposta | Sim | Endereço que recebe as respostas dos pagadores |
| Habilitada? | Não | Contas desabilitadas não enviam e não aparecem para escolha nas notificações |
Depois que a Kobana começa a preparar o domínio, Domínio e E-mail do Remetente ficam bloqueados para edição.
Validação do DNS
Ao salvar, a conta abre na aba Configuração DNS. A Kobana prepara os registros e os mostra numa tabela com Host, Tipo e Valor, cada um com botão para copiar. O e-mail cadastrado na sua conta Kobana também recebe uma mensagem com o assunto "[Ação Requerida] Configure os registros DNS para o domínio ...".
- Cadastre os registros no provedor de DNS do seu domínio.
- Clique em Validar Registros DNS. A Kobana também confere os registros automaticamente uma vez por dia.
- Quando todos os registros forem reconhecidos, a aba mostra "Registros DNS ativos" e a conta passa a enviar.
| Situação na aba Configuração DNS | O que significa |
|---|---|
| Configurando o servidor gerenciado | A Kobana está preparando os registros |
| Adicione os registros DNS | Os registros ainda não foram reconhecidos. A propagação deve ocorrer em até 72 horas da criação da conta; depois disso o processo segue um fluxo manual que pode levar até 7 dias |
| Registros DNS ativos | Conta pronta para uso |
| Falha na validação DNS | Os registros não foram reconhecidos. Confira o que foi publicado e valide de novo |
| Falha na verificação do DNS | Erro ao consultar o DNS. Tente mais tarde ou fale com o suporte |
| Identidade já existente | O domínio já está registrado em outra conta |
| Falha ao criar identidade | Erro na preparação. Use Tentar Novamente |
Contas com servidor SMTP próprio
Contas que usam um servidor SMTP próprio mostram, na edição, os campos Servidor SMTP, Porta, Autenticação, Verificação SSL, Servidor Seguro, Usuário, Senha e Limite de envios simultâneos. Ao salvar, a Kobana envia um e-mail de teste por esse servidor e só valida a conta se o envio funcionar; se falhar, a tela mostra o erro recebido do servidor.
Ações da conta
No menu Ações da conta: Alterar, Habilitar/Desabilitar, Nova Conta e Excluir. A aba Notificações lista as notificações que usam a conta. Uma conta com notificações vinculadas não pode ser excluída: remova ou mude a conta dessas notificações antes.
Notificação por e-mail
Onde fica: Automações > E-mails > Notificações.
Só é possível cadastrar notificações depois de ter ao menos uma conta de e-mail habilitada e validada; sem ela, o painel leva para o cadastro da conta.
Campos
| Campo | Obrigatório | Descrição |
|---|---|---|
| Conta de e-mail | Sim | Remetente. O campo só aparece quando há mais de uma conta ativa |
| Quando esse e-mail será disparado? | Sim | O evento que dispara o envio. Não pode ser alterado depois de criada a notificação |
| Template de E-mail | Sim | O template que envolve a mensagem |
| Carteira | Não | Limita a notificação a uma carteira de cobrança. Em branco, vale para todas |
| Assunto | Sim | Assunto do e-mail. Aceita variáveis |
| Mensagem | Sim | Corpo do e-mail, num editor visual. Aceita variáveis |
| PDF do boleto em anexo? | Não | Anexa o PDF do boleto ao e-mail |
| Com cópia oculta | Não | E-mails adicionais, separados por vírgula. Vão em cópia oculta. Quando o evento não tem e-mail de cliente, são os únicos destinatários; sem eles, o e-mail não é enviado |
| Filtrar os registros (boletos, clientes, etc) que tenham as etiquetas (tags) abaixo | Não | A notificação só dispara para registros com ao menos uma dessas etiquetas |
| Ativo? | Não | Liga ou desliga a notificação |
Variáveis
O botão de variáveis ao lado do Assunto e da Mensagem insere os dados do boleto no texto. Alguns exemplos, como aparecem no menu:
| Variável | Texto inserido |
|---|---|
| Nome do Cliente | {{ bank_billet.customer_person_name }} |
| Valor | {{ bank_billet.amount | money | prepend: "R$ " }} |
| Vencimento | {{ bank_billet.expire_at | date: "%d/%m/%Y" }} |
| Endereço (URL) | {{ bank_billet.url }} |
| Endereço (URL) em PDF | {{ bank_billet.formats.pdf }} |
| Linha digitável | {{ bank_billet.line }} |
| QR Code (Imagem) | {{ bank_billet.formats.pix_qrcode }} |
O menu também traz, entre outras, Contato, Demonstrativo, Número do documento, Parcela do carnê, Endereço do carnê (URL), Código de Barras (Imagem) e variações de mês e ano.
Ações
Na lista de notificações:
- Ver Notificação: mostra os dados e os e-mails já enviados por ela.
- Alterar Notificação, Ativar, Desativar.
- Seleção em massa: Ativar, Desativar e Excluir as notificações marcadas.
A tela de cada notificação lista os envios que ela gerou. O acompanhamento de todos os envios fica no histórico.
Como o envio acontece
- O evento ocorre (por exemplo, o boleto é pago).
- A Kobana procura as notificações ativas da conta para aquele evento, da carteira do boleto ou de todas as carteiras, e aplica o filtro de etiquetas.
- Para cada notificação que passa nos filtros, cria um envio com os destinatários (veja Quem recebe) e o coloca na fila. O envio é assíncrono.
- O envio aparece em Automações > E-mails > Histórico, com a situação atualizada à medida que o e-mail é entregue ao servidor de e-mail, aberto e clicado.
Permissões
No cadastro de usuários, módulo Automações: Contas de Email, Notificações de Email e Templates de Emails, cada uma com Ações Básicas, Criar, Alterar e Excluir.
Pela API
Contas de e-mail e envios também podem ser gerenciados pela API: veja a referência em API v2 e API v1.