Excursões - Comunicados da Excursão

O que é

A área de Comunicados da Excursão centraliza o envio de mensagens em massa relacionadas a uma viagem específica. Em vez de copiar contatos para WhatsApp ou disparar e-mails um a um, você seleciona o grupo (passageiros, guias, empresas de transporte), escreve a mensagem com variáveis dinâmicas e o sistema processa o envio em fila, mostrando o progresso em tempo real.

O usuário normalmente chega aqui em três momentos: antes da viagem (instruções de embarque, lembretes de pagamento), durante a viagem (alteração de roteiro, atraso, ponto de encontro) e depois (agradecimento, pesquisa de satisfação). Todo envio fica registrado no histórico, com contagem de enviados, falhas e a opção de cancelar enquanto o disparo ainda está em fila.

Como usar

1. Vá em Excursões no menu lateral.
2. Localize a excursão desejada na lista e abra o dropdown de ações da linha (botão de três pontos no canto direito).
3. Clique em Enviar Comunicado (ícone de megafone). O modal abre com o nome e a data da excursão no topo.
4. Na seção Destinatários, marque um ou mais grupos:
   • Passageiros - vem ativado por padrão.
   • Guias - guias atribuídos à excursão.
   • Empresas de Transporte - transportadoras vinculadas.
5. Para refinar a seleção dentro de um grupo, clique em Selecionar ao lado do grupo ativo. Use o campo Filtrar para buscar por nome ou e-mail e os atalhos Selecionar todos / Desmarcar todos.
6. Se o grupo Passageiros estiver ativo, ajuste o filtro Status dos passageiros marcando ou desmarcando Confirmados e Pendentes.
7. Em Canal de envio, escolha Apenas E-mail, Apenas WhatsApp ou E-mail + WhatsApp. As opções de WhatsApp ficam bloqueadas se o módulo não estiver ativo ou se a instância estiver desconectada.
8. Quando o canal incluir e-mail, preencha o Assunto do e-mail (obrigatório).
9. Digite o conteúdo em Mensagem. Use o link Ver variáveis disponíveis para inserir os placeholders {{nome_passageiro}}, {{nome_excursao}}, {{data_excursao}}, {{local_excursao}} e {{empresa_nome}} - basta clicar no nome da variável para colá-la no texto.
10. Confira o bloco azul mensagem(ns) serão enviadas - é o total real após aplicar filtros e validar contatos.
11. Clique em Enviar Comunicado no rodapé. Revise o resumo por canal e confirme em Confirmar Envio. O sistema enfileira os disparos e mostra o toast com a contagem.

Casos especiais

Selecionar apenas alguns passageiros

Mantenha o grupo Passageiros marcado, clique em Selecionar para expandir a lista e marque manualmente os nomes desejados. O contador ao lado do título do grupo passa a mostrar a fração selecionada (por exemplo, 3/24).

Filtrar por status (apenas Passageiros)

O bloco Status dos passageiros só aparece quando o grupo Passageiros está ativo. Desmarque Confirmados para enviar somente para pendentes (caso de cobrança) ou o contrário (caso de lembrete de embarque).

Enviar para guias e transportadoras junto

Marque os três grupos. O resumo de confirmação separa a contagem por tipo (passageiro(s), guia(s), empresa(s) de transporte) e por canal antes de você confirmar.

Acompanhar e cancelar um envio em fila

O histórico mostra a barra de progresso e o status (Pendente, Processando, Concluído, Cancelado). Enquanto o status estiver em Pendente ou Processando, o backend aceita a ação de cancelamento, que interrompe os envios ainda não despachados.

WhatsApp indisponível

Se o módulo WhatsApp não estiver ativo, as opções Apenas WhatsApp e E-mail + WhatsApp ficam desabilitadas e aparece o aviso "Ative o módulo WhatsApp para enviar por este canal." Se o módulo está ativo mas a instância está desconectada, o aviso vira "WhatsApp desconectado. Conecte aqui" com link direto para a tela de WhatsApp.

Erros comuns e como resolver

• "Selecione pelo menos um grupo de destinatários." - Causa: todos os checkboxes de grupo foram desmarcados. Solução: marque ao menos um grupo (Passageiros, Guias ou Empresas de Transporte).
• "Selecione pelo menos um destinatário." - Causa: o grupo está marcado, mas a lista individual foi totalmente desmarcada. Solução: clique em Selecionar todos ou marque ao menos um nome.
• "A mensagem é obrigatória." - Causa: campo Mensagem vazio. Solução: preencha o texto antes de enviar.
• "O assunto é obrigatório para envio por e-mail." - Causa: canal contém e-mail mas o campo Assunto está em branco. Solução: digite o assunto ou troque o canal para Apenas WhatsApp.
• "Nenhum destinatário com contato válido encontrado." - Causa: nenhum dos selecionados possui e-mail e/ou número de WhatsApp para o canal escolhido. Solução: cheque os cadastros em Passageiros / Guias / Transportes, corrija os contatos e reenvie.
• "Este comunicado não pode ser cancelado" - Causa: o status já está em Concluído ou Cancelado. Solução: nenhuma ação possível; o envio já foi processado ou abortado.

Onde encontrar

• URL: /admin/excursoes/{excursao}/comunicados
• Caminho no menu: Excursões > linha da excursão > dropdown de ações > Enviar Comunicado
• Permissão necessária: ver as viagens para ver o histórico; editar as viagens para enviar e cancelar
• Módulo necessário: nenhum para e-mail. whatsapp-mensagens ativo e conectado para enviar por WhatsApp

Veja também

• Gerenciar Passageiros
• Visão Geral das Excursões
• Checklist de Embarque