Pular para o conteúdo principal

E-mail inbound (Smart Email)

Para que serve​

O e-mail inbound dá à sua empresa caixas de e-mail próprias dentro do Tesselys, no formato prefixo@inbox.tesselys.com.br. Tudo o que chega nessas caixas é lido pelo sistema: os anexos (boletos, notas, guias, faturas de cartão) viram protocolos e, quando o e-mail pede uma ação no assunto, viram lançamentos, cobranças e notas fiscais.

Exemplo: você encaminha um boleto para contas@inbox.tesselys.com.br com o assunto [PAGAR] Aluguel novembro. O Tesselys lê o boleto, cria a despesa com valor e vencimento do documento e responde por e-mail com o resultado.

Não é a sua caixa de entrada

As caixas do e-mail inbound só recebem documentos para processamento. Elas não substituem o e-mail das pessoas nem o painel E-mail Pessoal do Tesselys.

Onde fica​

Ferramentas › E-mail Inbound da Empresa. A seção Ferramentas mostra só 5 itens: se não aparecer, procure em Ferramentas › Ver todos.

A tela tem três abas:

AbaO que mostraQuem vê
Caixas de EmailAs caixas da empresa, com endereço, regra, controle de remetente, status e e-mails recebidos nos últimos 30 diasQuem tem acesso à tela
Painel de ProcessamentosCada e-mail recebido, com status, remetente, assunto, anexos, caixa, protocolo e datasQuem tem permissão de ver as mensagens recebidas
Regras aprendidasAs correções que o sistema aprendeu ("este CNPJ é esta pessoa")Quem tem permissão de ver as regras aprendidas do Financeiro

Antes de começar​

  • A empresa precisa ter o módulo de Protocolos. Sem ele, a tela aparece como "em breve". Veja Protocolo e canais de ingestão.
  • Para a regra Protocolo Automático, tenha um canal criado em Sistema › Configurações › Canal de Ingestão.
  • As ações só funcionam com os módulos envolvidos contratados (Financeiro, Nota Fiscal, Cobrança, Cartões).

Passo a passo: criar uma caixa​

  1. Na aba Caixas de Email, clique em Novo.
  2. Em Endereço de Email, digite o prefixo. Enquanto você digita, a tela mostra o endereço completo e se ele está disponível.
  3. Escolha a Regra de Processamento e o Controle de Remetente.
  4. Se a regra for Protocolo Automático, escolha o Canal de Processamento.
  5. Salve. A caixa já começa a receber.
CampoPara que serve
Endereço de EmailO prefixo da caixa.
Regra de ProcessamentoO que o sistema faz com cada e-mail (veja abaixo).
Controle de RemetenteQuem pode enviar para a caixa: Apenas usuários internos (só usuários cadastrados na empresa; e-mails de desconhecidos são ignorados) ou Qualquer remetente (fornecedores, parceiros, clientes).
Canal de ProcessamentoO canal de ingestão onde os protocolos são criados. Obrigatório na regra Protocolo Automático.

Regras de processamento​

RegraComo funciona
IA / MarcadoresO e-mail é processado conforme a ação entre colchetes no assunto ([PAGAR], [FATURAR] etc.). E-mail sem marcador cria um protocolo para revisão.
Protocolo AutomáticoTodo e-mail recebido cria um protocolo no canal escolhido, sem precisar de marcador.

Gerenciando as caixas​

No cartão de cada caixa:

  • Copiar endereço: copia o e-mail completo para você divulgar ou cadastrar um encaminhamento.
  • Ver Emails: abre o Painel de Processamentos filtrado por aquela caixa.
  • Editar: muda endereço, regra, controle de remetente e canal. Ao trocar o endereço, e-mails enviados para o endereço antigo deixam de ser recebidos.
  • Inativar / Ativar: a caixa inativa para de processar o que chega; você pode ativá-la de novo depois.
Usando um e-mail da sua empresa

Para receber em um endereço do seu domínio (ex.: contas@suaempresa.com.br), configure no seu provedor de e-mail um encaminhamento automático para o endereço da caixa no Tesselys. Com Apenas usuários internos, o remetente original precisa ser usuário da empresa.

Como usar: ações no assunto​

Encaminhe ou escreva um e-mail para o endereço da caixa, com os documentos anexados, e coloque uma ação por e-mail entre colchetes no assunto. O sistema lê os anexos, cria o que a ação pede e responde por e-mail com o resultado.

Ação no assuntoO que fazGera
[PAGAR]Cria a despesa a partir dos anexos (boleto, nota, guia)Lançamento
[COBRAR]Cria a receita e a cobrança (boleto/PIX) para o clienteLançamento e cobrança
[EMITIR]Cria a receita e emite a nota fiscal vinculadaLançamento e nota fiscal
[FATURAR]Cria a receita, emite a nota e gera a cobrançaLançamento, nota fiscal e cobrança
[CARTAO]Com a fatura do cartão: confere as compras, lança as que faltam, fecha e registra o pagamento. Com um documento de compra (nota, invoice, recibo): lança a compra no cartãoLançamentos no cartão

Outros marcadores, que não criam lançamento:

MarcadorO que faz
[AJUDA]Responde por e-mail o guia com as ações, os ajustes e exemplos prontos.
[EMISSAO]Pedido de emissão de nota feito por um cliente ou fornecedor. Qualquer remetente pode mandar. Vira um pedido em revisão em Fiscal › Pedido de Emissão Fiscal, e alguém da empresa emite de lá. Não emite nada sozinho.

Cada ação só fica disponível quando a empresa tem os módulos envolvidos (Financeiro, Nota Fiscal, Cobrança, Cartões). A lista completa e atualizada abre em Saiba mais, no quadro "Como funciona" da aba Caixas de Email.

Ajustes no corpo do e-mail​

No corpo, você pode dizer ao sistema o que usar, uma linha por ajuste, no formato chave: valor. O que você escreve vale mais do que o sistema leu nos anexos. Linhas dentro de um e-mail encaminhado são ignoradas: só conta o que você escreveu.

GrupoAjustes
Classificaçãocategoria, centro de custo, unidade, workspace, conta, forma de pagamento
Dadostitulo, descricao, observacao, vencimento, competencia, valor, parcelas, pessoa, simular
Só para Pagarpagar pelo banco, agendar
Só para Cobrar e Faturartipo de cobranca, notificar
Só para Emitir e Faturarservico, cnae, iss retido, discriminacao, emails
Só para Cartãocartao, pagar, data pagamento, fechar
Vincularcopiar de (copia a classificação de um lançamento, cobrança, nota ou provisionamento), lancamento, nota, nota recebida, cobranca

Para cadastros (categoria, centro de custo, pessoa…), o número entre colchetes identifica o registro exato.

Exemplo:

Assunto: [PAGAR] Aluguel novembro

categoria: 2.01 Aluguel
centro de custo: ADM
pagar pelo banco: sim
Simule antes

Escreva simular: sim no corpo para receber, por e-mail, o que o sistema criaria, sem criar nada. Você pode revisar a simulação na tela: aprovar para executar ou pedir correção em texto livre. Quando você aprova uma correção de pessoa, o sistema aprende a regra para os próximos documentos.

Ao escrever para o endereço inbound pelo painel E-mail Pessoal do Tesselys (painel direito), os botões Inserir ação e Inserir variáveis montam o assunto e o corpo para você.

Anexos​

Envie os documentos em PDF, XML ou imagem. Se o PDF tiver senha, escreva a senha no corpo do e-mail. Anexo que não pode ser lido (PDF com senha não informada, arquivo danificado) fica de fora e é apontado no resultado.

Painel de Processamentos​

Mostra cada e-mail recebido. Os filtros rápidos separam Concluídos, Falhas e Processando; o filtro completo permite escolher status, caixa e período de recebimento, e o campo de busca procura por assunto ou remetente.

StatusSignificado
RecebidoO e-mail chegou e aguarda processamento
ProcessandoOs anexos estão sendo lidos
ConcluídoProcessamento terminado
FalhaAlgo impediu o processamento; veja o detalhe
IgnoradoO e-mail não foi processado (por exemplo, remetente não autorizado na caixa)

Clique em um e-mail para ver o detalhe: dados do e-mail, dados extraídos dos anexos (com o grau de confiança), instruções lidas do corpo, resultado (protocolo, fornecedor, lançamento, cobrança) e a linha do tempo do processamento.

Regras aprendidas​

Quando você aprova uma correção da simulação dizendo que um CNPJ ou nome é uma determinada pessoa, nasce uma regra: nos próximos documentos daquele CNPJ/nome, o sistema já usa a pessoa certa. A aba mostra quando a regra se aplica, qual pessoa ela usa, quantas vezes foi usada e quando foi aprendida.

Se uma regra ficou errada, clique em Inativar: o documento volta para a identificação normal. Aprovar uma nova correção cria a regra de novo.

Regras importantes​

Endereço da caixa​

RegraDetalhe
Caracteres e tamanhoDe 3 a 40 caracteres: letras minúsculas, números, ponto e hífen. A tela converte para minúsculas e tira acentos e espaços. Fora disso: "Nome inválido. Use de 3 a 40 caracteres: letras minúsculas, números, ponto e hífen."
Endereços reservadosNomes técnicos ou genéricos, como admin, suporte, support, contato, info, noreply, postmaster, são recusados: "Este endereço é reservado pelo sistema e não pode ser usado. Escolha outro."
ExclusividadeCada endereço pertence a uma só empresa no Tesselys. Se outra empresa já usa: "Este endereço já está em uso. Escolha outro."
Caixa inativa da sua empresaSe a sua empresa já teve a caixa e ela está inativa, a tela oferece Reativar caixa em vez de criar outra.

Quem pode enviar​

SituaçãoRegra
Caixa com Apenas usuários internosSó e-mails de usuários cadastrados na empresa são processados; os demais ficam como Ignorado.
[COBRAR], [EMITIR] e [FATURAR]Só são executadas quando o remetente é usuário ativo da empresa, mesmo em caixa aberta a qualquer remetente.
Acesso ao que a ação criaQuem envia precisa ter acesso ao que a ação cria (Financeiro, Nota Fiscal).
[EMISSAO]Qualquer remetente pode mandar. Não emite nada sozinho.

Permissões​

AçãoPermissão necessária
Ver as caixasAcesso à tela E-mail Inbound da Empresa no perfil
Criar, editar, inativar e ativar caixasPermissões de criar, editar e excluir dessa tela
Ver o Painel de ProcessamentosPermissão de ver as mensagens de e-mail inbound
Ver e inativar regras aprendidasPermissões das regras aprendidas do Smart Email (Financeiro)

Perguntas frequentes​

Posso criar mais de uma caixa?​

Sim. É comum separar, por exemplo, uma caixa para contas a pagar (aberta a fornecedores) e outra para comandos internos (só usuários da empresa).

Mandei um e-mail sem marcador. O que acontece?​

Na regra IA / Marcadores, o e-mail vira um protocolo para revisão. Na regra Protocolo Automático, todo e-mail vira protocolo no canal configurado.

Como sei o que o sistema fez com o meu e-mail?​

O Tesselys responde por e-mail com o resultado. Você também encontra tudo no Painel de Processamentos.

Meu e-mail aparece como Ignorado. Por quê?​

O caso mais comum é a caixa estar com Apenas usuários internos e o remetente não ser usuário da empresa. Troque para Qualquer remetente ou envie de um usuário cadastrado.

Mandei [COBRAR] de um endereço de fora e nada foi criado.​

[COBRAR], [EMITIR] e [FATURAR] só rodam quando quem envia é usuário ativo da empresa, mesmo em caixa aberta.

O endereço que eu quero diz "já está em uso".​

Outra empresa já usa esse prefixo; escolha outro. Se a mensagem for sobre uma caixa inativa da sua própria empresa, use Reativar caixa.

Esqueci quais ações e ajustes existem.​

Mande um e-mail com [AJUDA] no assunto para receber o guia, ou clique em Saiba mais no quadro "Como funciona" da aba Caixas de Email.

Ainda com dúvida?

A nossa equipe ajuda você a configurar e usar esse recurso.