Description
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_MESSAGESe 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
@newsletterdeve 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
@newsletterpode 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
@newslettere 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
@newsletterjá implementada para mensagens de texto - Imagem Docker com a funcionalidade ativa:
ghcr.io/feeh03114/evolution-api:latest - Repositório de origem: Feeh03114/evolution-api