DISCORD_SEND_MESSAGE - Enviar Mensagem de Texto no Discord

O que é este Node?

O DISCORD_SEND_MESSAGE é o node responsável por enviar mensagens de texto simples para canais do Discord usando webhooks ou bot token.

Por que este Node existe?

Integrar o Discord aos seus flows permite notificações em tempo real, alertas de sistema, comunicação com equipes e automações colaborativas. O DISCORD_SEND_MESSAGE existe para:

Notificações Instantâneas: Enviar alertas e notificações para equipes no Discord
Automação de Comunicação: Postar mensagens automáticas em canais específicos
Integrações de Bots: Criar bots personalizados que respondem a eventos do flow
Monitoramento: Enviar logs, status de sistemas e métricas para canais de monitoring

Como funciona internamente?

Quando o DISCORD_SEND_MESSAGE é executado, o sistema:

Valida Autenticação: Verifica se webhook URL ou bot token + channel ID estão corretos
Valida Conteúdo: Garante que a mensagem possui conteúdo válido
Prepara Payload: Monta o JSON com content, username, avatar, TTS e flags
Escolhe Método: Usa POST no webhook URL ou na API do Discord com bot token
Se Webhook: Envia via POST https://discord.com/api/webhooks/ID/TOKEN
Se Bot: Envia via POST https://discord.com/api/v10/channels/{channelId}/messages
Retorna Resposta: Devolve dados da mensagem criada incluindo message ID

Código interno (discord-executor.service.ts:273-300):

private async sendMessage(data: DiscordNodeData): Promise<any> {
  const payload: any = {
    content: data.content,
    tts: data.tts || false,
    flags: data.suppressEmbeds ? 1 << 2 : 0
  };

  if (data.authType === 'webhook') {
    if (data.username) payload.username = data.username;
    if (data.avatarUrl) payload.avatar_url = data.avatarUrl;
    if (data.threadId) payload.thread_id = data.threadId;

    const response: AxiosResponse = await axios.post(data.webhookUrl!, payload);
    return response.data;
  } else {
    const response: AxiosResponse = await axios.post(
      `${this.DISCORD_API_BASE}/channels/${data.channelId}/messages`,
      payload,
      {
        headers: {
          'Authorization': `Bot ${data.botToken}`,
          'Content-Type': 'application/json'
        }
      }
    );
    return response.data;
  }
}

Quando você DEVE usar este Node?

Use DISCORD_SEND_MESSAGE sempre que precisar de envio de mensagens de texto simples para o Discord:

Casos de uso

Alertas de Sistema: "Enviar notificação quando erro crítico ocorrer no backend"
Status de Pedidos: "Notificar equipe de vendas quando novo pedido for criado"
Logs de Automação: "Postar resumo diário de tarefas executadas no canal de logs"
Boas-vindas: "Enviar mensagem de boas-vindas quando novo membro entrar no servidor"
Monitoramento: "Alertar quando métrica ultrapassar threshold"

Quando NÃO usar DISCORD_SEND_MESSAGE

Mensagens Formatadas: Use DISCORD_SEND_EMBED para mensagens com formatação rica, cores e campos estruturados
Envio de Arquivos: Use DISCORD_SEND_FILE para enviar imagens, PDFs ou documentos
Editar Mensagens: Use DISCORD_EDIT_MESSAGE para modificar mensagens existentes
Deletar Mensagens: Use DISCORD_DELETE_MESSAGE para remover mensagens

Parâmetros Detalhados

authType (string, obrigatório)

O que é: Define o método de autenticação: webhook (mais simples, sem bot) ou bot (mais controle, requer bot token).

Valores possíveis: "webhook" ou "bot"

Flow completo para testar - Webhook:

{
  "name": "Teste Discord Send Message - Webhook",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "discord_1",
      "type": "discord",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Enviar Discord",
        "parameters": {
          "operation": "send_message",
          "authType": "webhook",
          "webhookUrl": "https://discord.com/api/webhooks/SEU_WEBHOOK_ID/SEU_WEBHOOK_TOKEN",
          "content": "Olá do Lumina Flow Builder! ✨"
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "Mensagem enviada com sucesso! ✅"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "discord_1" },
    { "source": "discord_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Teste: Substitua SEU_WEBHOOK_ID e SEU_WEBHOOK_TOKEN pelos valores reais do seu webhook Discord. Execute o flow e verifique se a mensagem aparece no canal.

Flow completo para testar - Bot:

{
  "name": "Teste Discord Send Message - Bot",
  "nodes": [
    {
      "id": "start_1",
      "type": "start",
      "position": { "x": 100, "y": 100 },
      "data": { "label": "Início" }
    },
    {
      "id": "discord_1",
      "type": "discord",
      "position": { "x": 300, "y": 100 },
      "data": {
        "label": "Enviar Discord Bot",
        "parameters": {
          "operation": "send_message",
          "authType": "bot",
          "botToken": "SEU_BOT_TOKEN",
          "channelId": "SEU_CHANNEL_ID",
          "content": "Mensagem enviada via Bot Token! 🤖"
        }
      }
    },
    {
      "id": "message_1",
      "type": "message",
      "position": { "x": 500, "y": 100 },
      "data": {
        "label": "Confirmar",
        "parameters": {
          "message": "Bot enviou a mensagem! ✅"
        }
      }
    },
    {
      "id": "end_1",
      "type": "end",
      "position": { "x": 700, "y": 100 },
      "data": { "label": "Fim" }
    }
  ],
  "edges": [
    { "source": "start_1", "target": "discord_1" },
    { "source": "discord_1", "target": "message_1" },
    { "source": "message_1", "target": "end_1" }
  ]
}

Teste: Configure seu bot token e channel ID. O bot precisa ter permissão Send Messages no canal.

webhookUrl (string, obrigatório se authType = "webhook")

O que é: URL completa do webhook do Discord. Obtida em Configurações do Canal → Integrações → Webhooks.

Formato: https://discord.com/api/webhooks/{webhook_id}/{webhook_token}