Pular para conteúdo

Discord Integration - Lumina Flow Builder

Visão Geral

A integração Discord permite enviar mensagens, embeds formatados, arquivos e gerenciar mensagens em canais do Discord diretamente dos seus flows.

Operações Disponíveis

1. SEND_MESSAGE - Enviar Mensagens de Texto

Envia mensagens de texto simples para canais Discord via webhook ou bot token.

Casos de uso: - Notificações de sistema - Alertas de eventos - Logs automáticos - Comunicação com equipes

Autenticação: Webhook ou Bot Token

2. SEND_EMBED - Enviar Embeds Formatados

Envia mensagens com formatação rica usando embeds do Discord (títulos, campos, cores, imagens).

Casos de uso: - Dashboards de métricas - Notificações de deploy - Status de sistemas - Relatórios estruturados - Perfis de usuário

Autenticação: Webhook ou Bot Token

3. SEND_FILE - Enviar Arquivos e Mídias

Envia arquivos, imagens, PDFs e documentos para canais Discord.

Casos de uso: - Relatórios em PDF - Screenshots de erros - Backups automáticos - Comprovantes de pagamento - Gráficos e visualizações

Autenticação: Webhook ou Bot Token

4. EDIT_MESSAGE - Editar Mensagens Existentes

Modifica conteúdo de mensagens já enviadas.

Casos de uso: - Atualizar status em tempo real - Dashboards dinâmicos - Progresso de tasks - Corrigir informações

Autenticação: Bot Token (obrigatório)

5. DELETE_MESSAGE - Deletar Mensagens

Remove mensagens existentes do canal.

Casos de uso: - Auto-destruct de mensagens sensíveis - Limpeza de status temporários - Moderação automática - Rollback em caso de erro

Autenticação: Bot Token (obrigatório)

Autenticação

Webhook URL

Quando usar: Notificações simples, automações básicas

Vantagens: - Fácil de configurar - Não requer bot - Ideal para envio de mensagens

Limitações: - Não pode editar mensagens - Não pode deletar mensagens - Sem controle total sobre mensagens

Como obter: 1. Vá em Configurações do Canal 2. Integrações → Webhooks 3. Criar Webhook 4. Copiar URL

Bot Token

Quando usar: Controle completo, edição, deleção

Vantagens: - Editar mensagens enviadas - Deletar mensagens - Controle total sobre canal - Gerenciar permissões

Limitações: - Requer criar aplicação Discord - Mais complexo de configurar - Precisa adicionar bot ao servidor

Como obter: 1. Discord Developer Portal 2. New Application 3. Bot → Add Bot 4. Copy Token 5. OAuth2 → Bot → Selecionar permissões 6. Adicionar bot ao servidor

Permissões necessárias: - Send Messages - Enviar mensagens - Embed Links - Enviar embeds - Attach Files - Enviar arquivos - Manage Messages - Editar/deletar mensagens (se necessário)

Comparação: Webhook vs Bot

Recurso Webhook Bot Token
Enviar mensagens ✅ ✅
Enviar embeds ✅ ✅
Enviar arquivos ✅ ✅
Editar mensagens ❌ ✅
Deletar mensagens ❌ ✅
Customizar username ✅ ❌
Customizar avatar ✅ ❌
Enviar em threads ✅ ✅
Configuração Simples Complexa
Rate limits Mais flexível Mais rigoroso

Limites do Discord

Mensagens

  • Conteúdo: 2000 caracteres
  • Embed title: 256 caracteres
  • Embed description: 4096 caracteres
  • Embed fields: 25 campos por embed
  • Field name: 256 caracteres
  • Field value: 1024 caracteres
  • Footer text: 2048 caracteres
  • Embeds por mensagem: 10

Arquivos

  • Tamanho máximo: 8 MB (100 MB com Nitro)
  • Arquivos por mensagem: 10

Rate Limits

  • Mensagens: 5 por 5 segundos por canal (webhook)
  • Mensagens: 50 por segundo (bot)
  • Edições: 5 por 5 segundos por canal
  • Deleções: 5 por 1 segundo por canal

Exemplos de Uso

Notificação Simples

START → DISCORD_SEND_MESSAGE → END

Dashboard Atualizado

START → DISCORD_SEND_EMBED → VARIABLE (save ID)
  → DELAY → DISCORD_EDIT_MESSAGE → END

Auto-Destruct

START → DISCORD_SEND_MESSAGE → VARIABLE (save ID)
  → DELAY → DISCORD_DELETE_MESSAGE → END

Envio de Relatório

START → DISCORD_SEND_FILE → MESSAGE → END

Status com Progresso

START → DISCORD_SEND_MESSAGE → VARIABLE
  → LOOP (tasks) → DISCORD_EDIT_MESSAGE → END

Boas Práticas Gerais

✅ Fazer: - Usar webhooks para notificações simples - Usar bot para controle completo - Validar tamanhos antes de enviar - Salvar message IDs para edição/deleção - Respeitar rate limits - Adicionar contexto às mensagens - Usar cores em embeds para status - Comprimir arquivos grandes

❌ Evitar: - Expor tokens em código - Enviar mensagens muito longas - Abusar de mentions (@everyone/@here) - Ignorar rate limits - Deletar logs importantes - Enviar spam - Hardcode credenciais

Cores Úteis (Decimal)

  • ✅ Verde (sucesso): 5763719 (#57F287)
  • ❌ Vermelho (erro): 15548997 (#ED4245)
  • ℹ️ Azul (info): 5793266 (#5865F2)
  • ⚠️ Amarelo (aviso): 16776960 (#FFFF00)
  • 🟣 Roxo (destaque): 10181046 (#9B59B6)
  • ⚫ Preto: 0 (#000000)
  • ⚪ Branco: 16777215 (#FFFFFF)

Converter Hex para Decimal: 

parseInt("57F287", 16) // = 5763719

Documentação Completa

Cada operação possui documentação completa com: - Explicação detalhada de funcionamento - Todos os parâmetros documentados - Código TypeScript real da implementação - Múltiplos exemplos testáveis - Flows JSON prontos para importar - Boas práticas e dicas - Casos de uso reais

Total: 5 operações documentadas | 5.322 linhas | 160KB de documentação

Última atualização: 2025-10-13