Contratos - Gerar e Enviar Links

O que é

Cada passageiro confirmado ou pendente de uma excursão recebe um link único e pessoal do contrato digital. Esse link leva o cliente à página de visualização e aceite, onde ele lê o contrato, confere os dados da viagem e registra o aceite com data, hora, IP e navegador.

O envio é sempre individual, por passageiro (ou por titular de grupo, quando há comprador principal com dependentes). O Viagilize não gera links em lote nem permite escolher um modelo de contrato no momento do envio - o template usado é o que estiver configurado para a excursão. Você normalmente chega nessa página logo após confirmar a reserva, ao notar que um passageiro está com status Pendente, ou quando precisa reenviar o link para alguém que perdeu o e-mail original.

Como usar

Copiar o link rapidamente pela lista

1. Vá em Excursões no menu principal e abra a excursão desejada.
2. Clique na aba Contratos dentro da excursão (ou acesse direto pelo botão Histórico de Aceites > voltar).
3. Localize o passageiro na lista. O status aparece em badge colorido ao lado do nome (Aceito, Pendente, Reaceite necessário ou Aguardando assinatura, conforme o caso).
4. Clique no dropdown de ações (ícone de três pontos verticais à direita da linha) e selecione Copiar Link.
5. O sistema gera o link pelo endpoint gerar-link, copia para a área de transferência e exibe um toast de confirmação. Cole o link onde quiser: WhatsApp manual, e-mail, SMS, etc.

Enviar pela página de detalhes do contrato

Use este caminho quando quiser revisar o contrato antes de mandar ou usar os botões dedicados de envio.

1. Na lista de Contratos da excursão, clique em Ver Contrato no dropdown de ações do passageiro.
2. No painel lateral Ações, escolha um dos botões:
   • Copiar Link do Contrato (botão verde) - copia para a área de transferência o link único do passageiro.
   • Enviar via WhatsApp (botão verde com ícone do WhatsApp) - abre uma janela do WhatsApp Web/App já com o número do cliente e uma mensagem pré-preenchida contendo o link. Disponível apenas se o cliente tiver telefone cadastrado.
3. Confira a mensagem e clique em enviar diretamente no WhatsApp.

Fluxo com Assinatura Eletrônica habilitada

Quando você usa o módulo de assinatura eletrônica, o painel Status do Contrato muda:

1. Se ainda não houver solicitação criada, aparece o botão Enviar Solicitacao de Assinatura (índigo). Clique nele para disparar a solicitação - o sistema gera o link assinado e envia o e-mail automaticamente.
2. Se já houver uma solicitação ativa, aparece Abrir Página de Assinatura com o link direto do agreement.
3. O badge na lista passa para Aguardando assinatura, Assinado, Recusado, Cancelado ou Nova versão necessária conforme o cliente avança.

Casos especiais

Grupo com comprador único e vários dependentes

A lista mostra um contrato por comprador, não um por passageiro. O representante eleito é o titular real (cliente_id = comprador_id) ou, na ausência dele, o primeiro passageiro do grupo. O link enviado cobre todos os passageiros do grupo na excursão e o valor exibido é a soma das ordens distintas do comprador.

Contrato invalidado após mudança no grupo

Se a composição do grupo (entrada/saída de dependentes, cancelamentos) mudar após um aceite, o sistema invalida o aceite anterior e marca como Reaceite necessário (badge laranja). Basta gerar e enviar o link novamente - o cliente vai aceitar a nova versão.

Cliente sem telefone ou sem e-mail

• Sem telefone: o botão Enviar via WhatsApp não aparece no painel Ações. Use Copiar Link do Contrato e mande por outro canal.
• Sem e-mail: o envio automático pelo sistema é bloqueado com a mensagem "Cliente não possui e-mail cadastrado.". Cadastre o e-mail no perfil do cliente antes de tentar novamente.

Convites pendentes e dependentes

Passageiros marcados com cadastrado_via igual a convite_pendente, link_convite ou link_convite_dependente e também os dependentes vinculados a um titular não aparecem como linhas próprias na lista de Contratos. Eles são gerenciados pelo contrato do titular do grupo.

Erros comuns e como resolver

• "Cliente não possui e-mail cadastrado." - Causa: o cliente do passageiro está sem e-mail no cadastro. Solução: edite o cliente em Clientes e cadastre o e-mail antes de reenviar.
• "Módulo de WhatsApp não está ativo na sua empresa." - Causa: o módulo whatsapp-mensagens não está habilitado. Solução: contrate/ative o módulo de WhatsApp ou use o botão Enviar via WhatsApp do painel lateral, que abre o WhatsApp do navegador sem precisar do módulo.
• "WhatsApp não está conectado. Configure o WhatsApp nas configurações." - Causa: a instância da Evolution não está pareada. Solução: vá nas configurações de WhatsApp e leia o QR Code para conectar a instância.
• "Cliente não possui telefone cadastrado." - Causa: o passageiro/cliente não tem telefone preenchido. Solução: cadastre o telefone no cliente e tente novamente.
• "Passageiro não encontrado." - Causa: o passageiro pertence a outra excursão (URL inconsistente). Solução: abra o passageiro pela própria excursão a que ele pertence.

Onde encontrar

• URL: /admin/excursoes/{excursao}/contratos
• Caminho no menu: Excursões > (abrir excursão) > aba Contratos
• Permissão necessária: ver as viagens (envios manuais por endpoint usam a mesma permissão da listagem)
• Módulo necessário: contratos-digitais (a aba Contratos só aparece se o módulo estiver ativo)

Veja também

• Contratos da Excursão
• Assinatura Digital
• Contratos Digitais - Módulo Adicional