Ajustar todos os endpoints para suportar envio com @newsletter #1723

Bem-vindo!

• Sim, pesquisei solicitações semelhantes no GitHub e não encontrei nenhum.

Qual tipo de recurso?

Funcionalidade

Qual a motivação para a solicitação?

💡 Tipo de recurso

Funcionalidade — Envio de mensagens para canais usando @newsletter

✨ Descrição da funcionalidade

Foi criada uma funcionalidade para envio de mensagens a canais utilizando a menção especial @newsletter.
Atualmente, somente o endpoint de mensagens de texto foi ajustado para esse comportamento.

O objetivo é permitir que mensagens específicas sejam enviadas diretamente aos inscritos via broadcast, facilitando a comunicação centralizada com usuários interessados.

🧩 Motivação

Essa funcionalidade permite ampliar a automação e segmentação de mensagens em canais, especialmente útil em canais com muitos membros.
Com o uso de @newsletter, bots e integrações conseguem enviar mensagens diretamente aos inscritos, sem depender de menções genéricas ou spam no canal.

🛠️ O que precisa ser feito

• Ajustar os demais endpoints de envio (ex: imagens, arquivos, vídeos, embeds, etc.) para aceitar @newsletter
• Validar permissões necessárias (SEND_MESSAGES e permissão especial para @newsletter)
• Documentar comportamento esperado para cada tipo de mensagem com @newsletter

📌 Observações

• Uma imagem representativa já foi criada para esse recurso.
• A sintaxe @newsletter deve ser mantida como padrão.
• Testes devem ser realizados em ambiente de staging antes do rollout final.

Exemplos de Uso

passa @newsletter.

Como o recurso deve ser desenvolvido?

A implementação pode seguir o mesmo padrão já utilizado para o endpoint já existentes, com possíveis ajustes:

• O tratamento do @newsletter pode ser feito diretamente no controller dos respectivos tipos de conteúdo.
• Como alternativa, pode ser criado um middleware reutilizável que verifica o uso de @newsletter e aplica a lógica comum de broadcast.
• Caso o volume de mensagens seja alto, considerar a utilização de um worker assíncrono para processar e distribuir as mensagens, especialmente arquivos grandes (vídeo/imagem).

Notas Adicionais

• Importante garantir retrocompatibilidade para mensagens normais sem @newsletter
• Verificar impacto em bots de terceiros e integrações existentes
• Pode haver implicações em taxas de entrega ou limites por canal dependendo da plataforma usada

🧷 Referências

• Estrutura de issue baseada em: WhiskeySockets/Baileys#1532
• Funcionalidade de envio com @newsletter já implementada para mensagens de texto
• Imagem Docker com a funcionalidade ativa: ghcr.io/feeh03114/evolution-api:latest
• Repositório de origem: Feeh03114/evolution-api