Buscar K
Aparência
Canais de Entrega
Um alerta pode enviar o mesmo conteúdo para múltiplos canais simultaneamente. O Lumo serializa cada bloco de conteúdo no formato apropriado a cada canal: uma mesma análise da IA vira texto formatado no email, texto plano no WhatsApp e dados estruturados no webhook.
| Canal | Texto | Imagem inline | PDF/XLSX | Observação |
|---|---|---|---|---|
| ✅ HTML | ✅ Embutida | ✅ Anexo | Suporta múltiplos destinatários, formatação rica | |
| ✅ | ✅ Imagem separada | ✅ Documento | Requer instância de WhatsApp configurada no tenant | |
| Telegram | ✅ | ✅ Imagem separada | ✅ Documento | Mensagens diretas (1:1) apenas |
| Webhook | ✅ JSON | URL no payload | URL no payload | Sua aplicação recebe e renderiza como quiser |
TIP
Misture canais conforme a urgência. Anomalias críticas no WhatsApp (push imediato), digests detalhados no Email (com anexos), integrações com sistemas internos via Webhook.
Email
Configuração
O Lumo usa o servidor SMTP configurado no tenant (ver HEC > Tenants > Configurações de Email). Cada tenant pode usar seu próprio SMTP (Gmail, Office365, SendGrid, servidor interno) ou o SMTP padrão do Lumo.
Destinatários
Selecionados na aba "Destinatários" do alerta:
- Usuários do tenant: pickup direto da lista de usuários
- Grupos de usuários: todos os membros ativos
- Emails externos: pessoas fora do tenant. Esta opção precisa estar habilitada nas configurações do tenant (HEC > Tenants > Avançado). Se estiver desabilitada, o campo não aparece e só dá pra escolher usuários e grupos cadastrados.
Formato
- Assunto: nome do alerta + data
- Corpo HTML: bloco de texto com variáveis renderizadas e imagens inline (gráficos)
- Anexos: arquivos de relatório (PDF, XLSX)
WARNING
SMTP configurado errado é a causa mais comum de "alertas não chegam". Teste com o botão "Testar Configuração SMTP" no painel do tenant antes de ativar alertas em produção.
WhatsApp
Pré-requisito: Instância configurada no Tenant
WhatsApp só funciona se o administrador do tenant tiver configurado uma instância no HEC (em HEC > Tenants > Integrações > WhatsApp). Sem isso, as mensagens não são enviadas, mesmo que o alerta esteja ativo e o canal marcado.
A instância é uma conexão com a API do WhatsApp Business (ou com um gateway equivalente conforme contratado). Cada tenant tem sua própria instância, dedicada.
WARNING
Sem instância configurada, o alerta dispara, gera os conteúdos, e a entrega para o canal WhatsApp falha silenciosamente (registrada como erro no histórico). Verifique a configuração antes de ativar alertas com WhatsApp.
Telefone do Destinatário
O número de WhatsApp para onde a mensagem é enviada vem do perfil de cada usuário do Lumo, no mesmo lugar onde se ajusta nome, foto e outras informações pessoais (acessível pelo menu do usuário no canto superior direito da plataforma).
Se o usuário não tem telefone cadastrado no perfil, ele não recebe alertas via WhatsApp, mesmo que esteja na lista de destinatários.
Comportamento
- Cada bloco de texto vira uma mensagem
- Gráficos viram imagens enviadas separadamente
- Relatórios PDF/XLSX viram documentos anexados
Limites
| Limite | Valor |
|---|---|
| Tamanho de anexo | 100 MB (PDF/XLSX) |
| Tamanho de imagem | 5 MB |
Telegram
Funcionalmente similar ao WhatsApp, mas via bot do Telegram.
Setup
- Administrador do tenant cadastra o token do bot em HEC > Tenants > Integrações > Telegram
- Cada usuário precisa iniciar conversa com o bot uma vez para receber mensagens (limitação do Telegram, não do Lumo). Isso é feito clicando no link do bot e enviando
/start - O Telegram ID do usuário é cadastrado no perfil dele (mesmo lugar onde edita nome, foto, telefone)
Mensagens Diretas Apenas
O Telegram do Lumo envia somente para conversas diretas (1:1). Não há suporte a grupos. Isso é uma decisão deliberada: enviar dados sensíveis para grupos com membros que não passaram pelo controle de acesso do tenant criaria risco de vazamento.
Se você precisa que múltiplas pessoas recebam o mesmo alerta, adicione cada uma como destinatário individual ou crie um grupo no Lumo (que expande pra cada membro).
Vantagens vs WhatsApp
- ✅ Sem limite de mensagens/dia
- ✅ Sem custo de API (Telegram é gratuito)
- ❌ Adoção menor que WhatsApp em equipes corporativas no Brasil
Webhook
Canal de integração: entrega o conteúdo do alerta como payload JSON numa URL HTTPS que você controla. Use para:
- Integrações customizadas com sistemas internos (helpdesk, CRM, ERP)
- Automação no-code/low-code (n8n, Make, Zapier)
- Gateways próprios de mensageria (instância própria de WhatsApp via Meta, Slack, Teams)
- Logs externos de auditoria
Como funciona, em resumo:
- A URL é única por tenant (em HEC → Tenants → Canais de Alerta Permitidos → URL do Webhook), não por alerta.
- Para cada entrega e cada destinatário, o Lumo faz um
POSTJSON no formato documentado. - Retentativas com backoff exponencial até 8 tentativas; falha em webhook não derruba os outros canais.
TIP
Para a referência completa do payload, exemplos de fluxos em n8n/Make/Zapier e código receptor em Node.js/Python, veja Webhook.
Falhas e Auditoria
Toda entrega gera um registro auditável com:
- Status (sucesso, falha, parcial)
- Mensagem de erro humana quando falha (localizada no idioma do usuário)
- Tempo de cada canal
Filosofia "fail loud": se qualquer canal esperado falhar, a entrega inteira fica com status de erro. Não há falha silenciosa, o usuário precisa saber que algo não foi entregue.
Veja o histórico de entregas em Alertas > Histórico (modal do alerta).
Próximos Passos
- Volte para Visão Geral e configure disparo + conteúdo
- Para regras de envio condicional, Condicional
- Permissões de quem pode editar canais: Permissões