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.
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:
| Aba | O que mostra | Quem vê |
|---|---|---|
| Caixas de Email | As caixas da empresa, com endereço, regra, controle de remetente, status e e-mails recebidos nos últimos 30 dias | Quem tem acesso à tela |
| Painel de Processamentos | Cada e-mail recebido, com status, remetente, assunto, anexos, caixa, protocolo e datas | Quem tem permissão de ver as mensagens recebidas |
| Regras aprendidas | As 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
- Na aba Caixas de Email, clique em Novo.
- Em Endereço de Email, digite o prefixo. Enquanto você digita, a tela mostra o endereço completo e se ele está disponível.
- Escolha a Regra de Processamento e o Controle de Remetente.
- Se a regra for Protocolo Automático, escolha o Canal de Processamento.
- Salve. A caixa já começa a receber.
| Campo | Para que serve |
|---|---|
| Endereço de Email | O prefixo da caixa. |
| Regra de Processamento | O que o sistema faz com cada e-mail (veja abaixo). |
| Controle de Remetente | Quem 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 Processamento | O canal de ingestão onde os protocolos são criados. Obrigatório na regra Protocolo Automático. |
Regras de processamento
| Regra | Como funciona |
|---|---|
| IA / Marcadores | O 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ático | Todo 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.
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 assunto | O que faz | Gera |
|---|---|---|
[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 cliente | Lançamento e cobrança |
[EMITIR] | Cria a receita e emite a nota fiscal vinculada | Lançamento e nota fiscal |
[FATURAR] | Cria a receita, emite a nota e gera a cobrança | Lanç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ão | Lançamentos no cartão |
Outros marcadores, que não criam lançamento:
| Marcador | O 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.
| Grupo | Ajustes |
|---|---|
| Classificação | categoria, centro de custo, unidade, workspace, conta, forma de pagamento |
| Dados | titulo, descricao, observacao, vencimento, competencia, valor, parcelas, pessoa, simular |
| Só para Pagar | pagar pelo banco, agendar |
| Só para Cobrar e Faturar | tipo de cobranca, notificar |
| Só para Emitir e Faturar | servico, cnae, iss retido, discriminacao, emails |
| Só para Cartão | cartao, pagar, data pagamento, fechar |
| Vincular | copiar 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
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.
| Status | Significado |
|---|---|
| Recebido | O e-mail chegou e aguarda processamento |
| Processando | Os anexos estão sendo lidos |
| Concluído | Processamento terminado |
| Falha | Algo impediu o processamento; veja o detalhe |
| Ignorado | O 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
| Regra | Detalhe |
|---|---|
| Caracteres e tamanho | De 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 reservados | Nomes 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." |
| Exclusividade | Cada 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 empresa | Se 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ção | Regra |
|---|---|
| Caixa com Apenas usuários internos | Só 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 cria | Quem 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ção | Permissão necessária |
|---|---|
| Ver as caixas | Acesso à tela E-mail Inbound da Empresa no perfil |
| Criar, editar, inativar e ativar caixas | Permissões de criar, editar e excluir dessa tela |
| Ver o Painel de Processamentos | Permissão de ver as mensagens de e-mail inbound |
| Ver e inativar regras aprendidas | Permissõ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.
A nossa equipe ajuda você a configurar e usar esse recurso.