Buscar K
Aparência
Canais e entrega
- Tipo
- Referência
- Para
- Analista, Administrador do Tenant
- Na tela
- DataViz › Alertas › Criar alerta › Dados gerais › Canais de Envio do Alerta
Um alerta pode sair por E-mail, WhatsApp, Telegram e Webhook ao mesmo tempo, marcados na seção Canais de Envio do Alerta. O conteúdo é o mesmo em todos; muda o jeito de chegar. A lista só mostra os canais liberados para o Tenant (veja permissões e destinatários).
| Canal | Como chega | O que precisa existir |
|---|---|---|
| Uma mensagem com o conteúdo no corpo, links para os relatórios e PDFs em anexo | O e-mail do usuário (o login) | |
| Uma sequência de mensagens, ou um PDF consolidado | Telefone no perfil do destinatário e um número de envio para o Tenant | |
| Telegram | Uma sequência de mensagens do bot | Bot configurado e o usuário vinculado a ele |
| Webhook | Um POST JSON por destinatário na URL do Tenant | URL configurada no Tenant |
Uma falha num canal não interrompe os outros: se o WhatsApp de uma pessoa falha, o e-mail dela sai.
E-mail
O assunto é o nome do alerta; com bloco de Investigação, o assunto vem da investigação. Textos, análises de IA, gráficos e Dashboards em imagem vão no corpo. Relatórios viram botões Baixar PDF e Baixar Excel, com links. Dashboard em PDF e o PDF da investigação vão anexados até 9 MB; acima disso, como link. O envio usa o SMTP do Tenant, depois o do Cliente e, sem nenhum, o da plataforma.
WhatsApp
O número de destino é o Telefone do perfil de cada destinatário, em minha conta. Sem telefone, aquela pessoa não recebe pelo WhatsApp, e o canal fica Falhou no histórico.
O número que envia depende do que está configurado para o Tenant e para o Cliente dele, e o formato da mensagem muda conforme o caminho. A ordem e as diferenças estão em WhatsApp.
Telegram
O alerta chega como mensagens do bot: primeiro o nome do alerta e o ambiente, depois um item por bloco (texto como mensagem, gráfico como imagem, relatório e PDF como documento). O Telegram entrega cada item separado, sem consolidar.
Para receber, cada pessoa vincula a conta dela ao bot uma vez: em minha conta, na seção Telegram, abre o link do bot e envia o Código de segurança mostrado ali. O código vale para o Tenant em que foi gerado, e o alerta vai para a conversa em que ele foi enviado. Sem vínculo, o canal fica Falhou.
Webhook
Para cada entrega, o Lumo faz um POST com o conteúdo em JSON para a URL configurada no Tenant, um por destinatário. Arquivos vão como links. Configuração, contrato e receptor estão em webhook.
Quando a entrega vira um PDF
No WhatsApp por instância, cada item visual vai como mensagem separada até 4 itens. A partir do quinto, o alerta inteiro vira um PDF consolidado com uma mensagem de resumo, para não encher a conversa.
Contam como item visual: gráfico, Dashboard, relatório com PDF e investigação com PDF anexado. Texto, análise de IA, relatório só em XLSX e bloco que falhou não contam. Se o PDF consolidado não puder ser gerado, o envio volta a ser item a item.
No WhatsApp oficial da Meta, o alerta sai sempre como um PDF anexado ao template, com qualquer quantidade de itens.
O painel Como este alerta será entregue, na aba Conteúdo, conta os itens do alerta e diz se o WhatsApp recebe item a item ou um PDF consolidado. Ele trata WhatsApp e Telegram juntos e não considera o WhatsApp oficial, então confie nas regras acima.
Histórico de envio
Na lista de alertas, o menu de cada alerta tem Histórico de Envio, com cada execução e o resultado por destinatário e canal.
| Situação do canal | Quer dizer |
|---|---|
| Na fila | Ainda não saiu |
| Enviado | O canal aceitou a mensagem |
| Entregue | Chegou ao aparelho ou à caixa (quando o canal informa) |
| Falhou | Não foi entregue, inclusive por falta de telefone ou de vínculo com o Telegram; o detalhe traz o motivo |
| Não enviado | O canal não chegou a ser tentado para aquela pessoa |
Ao abrir um canal, a linha do tempo mostra também quando a mensagem foi lida, se o canal informa.
Na lista de alertas, a última execução aparece como Parcial quando só parte dos envios chegou e Falhou quando nenhum chegou; dentro do histórico, as execuções aparecem como Envio Completo, Parcial com Erros, Erro ou Processando. No resumo, o motivo de cada falha vem em linguagem de usuário, começando por Seus dados de contato para este canal parecem incorretos ou O servidor de e-mail do tenant falhou; ao abrir o canal, aparece o erro técnico do provedor.
Quem é usuário de mais de um ambiente vê Ver todas as entregas da plataforma, com os alertas que recebe em todos eles, só para leitura.
Enviar fora do horário
Forçar Envio, na lista, dispara o alerta na hora, mesmo com o alerta inativo. Quem pode compartilhar alertas escolhe os destinatários; os outros enviam para todos os do alerta. É o jeito de testar um canal de verdade; Pré-visualizar só mostra o conteúdo na tela.