Enviar uma mensagem em massa

Use envio de mensagem em massa quando você tem um aviso, um lembrete de culto, ou um acompanhamento que deve chegar a toda uma fatia de membros de uma só vez. A ação em massa entrega ao mesmo motor de mensageria que alimenta os envios para um único membro, então templates, variáveis, tratamento de descadastramento, e roteamento por canal funcionam todos da mesma forma.

Abrir o compositor

A partir da lista de membros, construa sua seleção, abra o dropdown Mais ações na barra de ações, e clique em Enviar mensagem. O compositor padrão de mensagem abre, pré-preenchido com a contagem de seleção na pílula de destinatário.

Escolher um canal

O compositor oferece todo canal que sua org configurou:

Canal	Configuração	Velocidade
WhatsApp	Requer um remetente WhatsApp Business aprovado	Quase instantâneo por mensagem
SMS	Requer uma configuração Twilio (ou equivalente)	Quase instantâneo
E-mail	Requer um domínio de remetente verificado	Segundos a minutos

Se um canal não está configurado, a opção fica escondida. Veja Mensageria para a configuração por canal.

TIP

Para avisos que não são críticos em tempo, o e-mail é o caminho mais barato por mensagem. Para lembretes de dia de culto, WhatsApp ou SMS chegam na tela de bloqueio e são lidos.

Redigir o corpo

Você pode:

• Digitar o corpo inline — suporta variáveis como e renderizadas por destinatário no momento do envio.
• Escolher um template — o dropdown mostra todo template aprovado para o canal escolhido. Templates são obrigatórios para WhatsApp.
• Agendar para depois — solte uma data e hora; a ação fica em queued até o agendamento disparar.

O compositor sinaliza qualquer destinatário cujo canal não esteja acessível (sem telefone, descadastrado do SMS, e-mail inválido). Eles aparecem como falhas na lista de itens com falha da ação em massa quando o envio termina.

Como o envio em massa realmente roda

Enviar mensagem é uma ação em massa delegada. Isso significa:

1. A linha de ação em massa é criada e muda para processing.
2. A edge function entrega os IDs alvo + corpo da mensagem para a função send-message com source: "bulk_action" e o ID da ação em massa.
3. A função send-message se ramifica em linhas message_logs por destinatário, cada uma roteada pelo adaptador de canal certo.
4. A linha de ação em massa muda para delegated. Um cron de reconciliação rastreia quantas das mensagens chegaram e atualiza success_count / failed_count à medida que as entregas voltam.

WARNING

Uma ação em massa delegated permanece nesse status até a fila de mensageria terminar. Para grandes envios de WhatsApp, isso pode se estender por minutos ou horas dependendo dos limites de taxa do seu remetente. A barra de progresso atualiza à medida que as entregas são confirmadas.

Tratamento de descadastramento

Destinatários que se descadastraram de um canal são filtrados antes da fila ser construída. Eles aparecem na lista de itens com falha com o motivo "Descadastrado de [canal]," mas não contam como erros contra você — descadastramentos são um sinal forte que você deve respeitar.

O descadastramento se aplica por canal. Um membro que se descadastrou do SMS ainda pode receber e-mail; a ação em massa trata cada canal independentemente.

Veja Canais e descadastramento para o modelo de descadastramento em detalhe.

Rastrear a conversa

Toda mensagem em massa chega no Registro de comunicação (Mensageria → Registro de comunicação) marcada com source: bulk_action e o ID da ação em massa. Isso te dá:

• Uma linha do tempo única por destinatário mostrando o que ele recebeu.
• Uma busca reversa da resposta de um destinatário de volta para a ação em massa originária.
• Taxas agregadas de entrega por envio em massa — útil para "o aviso chegou?"

Respostas bidirecionais

Respostas de WhatsApp e SMS vão para a caixa de entrada Conversas. A resposta é vinculada à ação em massa que enviou o gatilho, então quando Mary responde "Vou estar lá" ao lembrete do culto, você pode ver a qual campanha ela está respondendo sem rolar.

Respostas por e-mail seguem o e-mail normal — vão para o endereço de resposta configurado, não para a caixa de entrada de conversas.

Permissões

Ação	Permissão necessária
Abrir enviar-mensagem na barra de ações	members.edit E messaging.send
Usar um template não aprovado	messaging.template_override
Agendar para depois	Mesma que envio imediato

Sem messaging.send, a opção fica escondida do dropdown inteiramente.

Perguntas comuns

Qual é o limite de taxa? O limite de taxa por org é de 10 invocações de ação em massa por minuto. A vazão por canal é regida pela configuração do seu remetente — veja WhatsApp, SMS, E-mail.

Posso cancelar no meio do envio? Sim, mas só para envios ainda em queued. Uma vez que muda para delegated, as mensagens estão sendo despachadas e as individuais não podem ser revogadas.

Onde terminam as falhas? Na tabela de itens com falha da ação em massa, com o erro por destinatário (sem telefone, descadastrado, template rejeitado, etc.). Você pode tentar de novo — mas para descadastramentos, tentar de novo falha de novo.

Próximos passos

• Monitoramento e tentativas — rastreie o envio delegado.
• Conversas — trate das respostas.
• Canais e descadastramento — gerencie descadastramentos.