O que foi desenvolvido?

Foi adicionada uma nova ação às funcionalidades de Vencimento de Leads e Vencimento por Empreendimento: Alterar situação do lead.

Ao selecionar essa ação, o usuário poderá escolher, por meio de um select, para qual situação do workflow o lead deverá ser direcionado quando vencer naquela etapa.

O select exibirá somente as situações ativas do workflow.

Como funciona?

Ao ocorrer o vencimento do lead, caso a ação Alterar situação do lead esteja configurada, o lead será automaticamente direcionado para a situação selecionada.

As ações configuradas entre a situação atual e a situação de destino do workflow, caso existam, serão executadas normalmente.

Porém, nesse processo, os pré-requisitos configurados no workflow serão ignorados, permitindo que o lead seja direcionado para a situação definida mesmo que não atenda às condições normalmente exigidas para entrada nessa etapa.

Qual o benefício?

A melhoria permite que o gestor tenha maior controle sobre o comportamento dos leads após o vencimento, podendo definir automaticamente o próximo estágio do lead no workflow.

Isso reduz a necessidade de movimentações manuais e permite criar fluxos específicos para leads que não foram tratados dentro do prazo definido, mantendo a execução das ações da etapa de destino sem impedir a movimentação por conta de seus pré-requisitos.

1. O que foi desenvolvido?

Foi criada uma nova configuração de específico para a integração com o Facebook, permitindo que o cliente defina se os leads que ficaram pendentes devido a erros ou falhas de permissão deverão ser processados novamente após a normalização da integração.

2. Qual problema essa melhoria resolve?

Atualmente, quando ocorre uma falha de permissão no Facebook, os leads podem permanecer pendentes. Em alguns casos, o cliente acaba realizando o cadastro ou a importação desses leads manualmente para não perder as oportunidades.

Quando a integração é normalizada, esses leads pendentes podem voltar a ser processados, fazendo com que sejam convertidos novamente de forma atrasada ou gerando duplicidade no fluxo do cliente.

A nova configuração permite que o cliente tenha controle sobre esse comportamento, evitando o reprocessamento de leads que já foram tratados por outro meio.

3. Qual o benefício para o cliente?

Maior controle sobre o recebimento dos leads provenientes do Facebook, permitindo que cada cliente defina o comportamento mais adequado para sua operação e evitando que leads tratados manualmente durante uma indisponibilidade da integração retornem posteriormente de forma inesperada.

🔹 O que é?
A API que retorna os contratos assinados por assinatura eletrônica de uma reserva passou a devolver também o link de acesso ao documento assinado, no índice link_contrato_assinado. A melhoria é voltada para quem utiliza o DocuSign como plataforma de assinatura eletrônica.

🔹 Por que é importante?
Antes, quem consumia a API sabia que o contrato havia sido assinado, mas precisava entrar na plataforma de assinatura ou no CV para chegar até o documento. Agora o link vem junto na própria resposta, permitindo que sistemas integrados acessem, armazenem ou disponibilizem o contrato assinado automaticamente, sem etapa manual no meio do caminho.

🔹 Como funciona?

• Faça a chamada no endpoint api/v3/comercial/reservas/{idreserva}/contratos-assinados, informando o ID da reserva.
• A resposta traz os contratos assinados por assinatura eletrônica daquela reserva e, para cada um, o índice link_contrato_assinado.
• O índice vem preenchido apenas para contratos assinados via DocuSign. Para as demais plataformas de assinatura eletrônica, o campo é retornado vazio.
  
  OBS: para os 3 serviços de assinatura temos como baixar o documento assinado, para Clicksign e CV Sign é no link da API, para o Docusign tem uma diferença pois é fornecido pela integração o certificado e o contrato assinado de forma separada e por isso, foi adicionado essa melhoria. 

🔹 O que é?
As variáveis extras do tipo moeda — criadas recentemente no sistema — agora geram automaticamente duas variáveis de contrato: uma com o valor informado no campo e outra com esse mesmo valor por extenso.

🔹 Por que é importante?
Contratos costumam exigir que valores monetários apareçam em algarismos e por extenso. Antes, esse texto precisava ser escrito manualmente, o que abria espaço para erro de digitação e divergência em relação ao valor real. Agora o extenso é gerado a partir do próprio valor da variável, mantendo os dois formatos sempre iguais.

🔹 Como funciona?

• Em Contratos > Criar Variáveis, cadastre a nova variável escolhendo o tipo Moeda.
• Ao salvar, o sistema disponibiliza automaticamente duas variáveis na lista de variáveis do contrato:
  • [[EXTRAS][NOME_DA_VARIAVEL]] — traz o valor informado no campo.
  • [[EXTRAS][NOME_DA_VARIAVEL_EXTENSO]] — traz esse mesmo valor escrito por extenso.
• No editor do contrato, clique na variável desejada para inseri-la no texto. Você pode usar as duas juntas, no formato usual de contratos (valor seguido do extenso).

Agora é possível controlar, por perfil de acesso, quem pode abrir assistência técnica em áreas comuns e em localidades pelo Painel Gestor.

O que foi entregue:

• Duas novas permissões no perfil de acesso: uma para abertura em áreas comuns e outra para localidades
• Bloqueio automático da abertura em área comum quando a permissão estiver desmarcada no perfil
• Solicitações originadas pelo cliente passam a ter escopo restrito à unidade dele

Como configurar:

1. Acesse o cadastro de Perfis de acesso no Painel Gestor
2. Localize as permissões de abertura de assistência em áreas comuns e localidades
3. Desmarque as permissões nos perfis que não devem ter essa autonomia

Por que isso importa:

• Garante que a abertura em área comum aconteça somente quando houver respaldo formal do síndico, evitando chamados sem legitimidade
• Reduz retrabalho da equipe de assistência com solicitações abertas fora do escopo correto
• Deixa claro o limite de atuação de cada perfil, diminuindo divergência entre o que o cliente solicita e o que a construtora atende

Nas bases já existentes, os perfis seguem com a permissão liberada — o comportamento atual não muda. O bloqueio só passa a valer quando você desmarcar a permissão no perfil.

O que foi feito:
O endpoint PUT de assistência passou a aceitar o envio de campos adicionais (customizados) diretamente no payload da requisição, bastando informar o ID do campo adicional e o valor correspondente. Antes, a atualização desses campos exigia uma chamada separada; agora ela pode ser feita na mesma requisição de atualização da assistência.

Por que é importante para o produto:
Reduz o número de chamadas necessárias para manter a assistência atualizada, simplifica a integração para clientes que usam campos customizados no fluxo de atendimento/assistência técnica, e elimina risco de inconsistência entre a atualização da assistência e a dos seus campos adicionais (que antes podiam ficar dessincronizados por serem chamadas separadas).

Nova configuração que permite ocultar os campos de descrição e de anexo de arquivos no cadastro da assistência.

O que foi entregue:
- Flag de configuração para ocultar os campos de descrição e arquivos no formulário de abertura da assistência
- Com a flag ativa, os dois campos deixam de ser exibidos, e a abertura segue apenas com as informações restantes do cadastro
- Os demais campos do formulário continuam funcionando normalmente

Por que isso importa:
- Operações que padronizam a abertura pela seleção do item não precisam mais de um campo livre que só gera texto solto para triar depois
- Menos campos no formulário reduz a desistência no meio da abertura, especialmente quando o cliente acessa pelo celular
- Evita o recebimento de anexos irrelevantes ou pesados em fluxos onde o registro visual é feito na vistoria, não na abertura
- Quem usa descrição e anexos como parte da triagem continua com tudo como está hoje

A configuração é opcional e não altera assistências já abertas. Enquanto não for ativada, o formulário segue exibindo todos os campos.

Nova configuração que restringe a assistência a um único item, tanto no Portal do Cliente quanto no Painel Gestor.

O que foi entregue:
- Flag de configuração que limita a assistência a 1 item
- Com a flag ativa, depois que o primeiro item é adicionado, a opção de incluir novo item deixa de ser exibida
- A regra vale nos dois pontos de abertura: Portal do Cliente e Painel Gestor

Por que isso importa:
- Operações que tratam cada problema como um chamado próprio param de receber assistências com vários itens misturados, o que atrapalha SLA, responsável e histórico
- Um item por assistência elimina a ambiguidade de garantia: não existe mais o caso de um chamado com itens dentro e fora do prazo ao mesmo tempo
- O bloqueio acontece na própria tela, então o cliente e o atendente não precisam saber a regra de cabeça

A configuração é opcional. Enquanto não for ativada, a abertura de assistência continua aceitando múltiplos itens como hoje.

O Workflow de Assistência ganhou duas novas flags, "Dentro da Garantia" e "Fora de Garantia", que direcionam a assistência automaticamente para a situação correta no momento da criação.

O que foi entregue:
- Flag "Dentro da Garantia": assistências criadas com item dentro do prazo de garantia são alocadas na situação onde a flag estiver
- Flag "Fora de Garantia": assistências criadas com item fora do prazo são migradas para a situação onde a flag estiver
- Quando a assistência tem mais de um item e pelo menos um está fora de garantia, ela é direcionada para a situação de fora de garantia

Como configurar:
1. Acesse as configurações do Workflow de Assistência Técnica
2. Aloque a flag "Dentro da Garantia" na situação que deve receber esses chamados
3. Repita o passo para a flag "Fora de Garantia" na situação correspondente

Por que isso importa:
- A triagem de garantia deixa de ser manual, eliminando a etapa em que alguém precisa conferir o prazo do item e mover o chamado
- Reduz o risco de uma assistência fora de garantia seguir o fluxo de atendimento coberto, com custo indevido para a construtora
- Cada situação passa a refletir de fato o tipo de tratativa, o que melhora a leitura dos indicadores do workflow
- O direcionamento acontece na criação, então o chamado já nasce na fila certa

As flags só passam a valer nas situações em que forem alocadas. Enquanto não forem configuradas, o workflow segue funcionando exatamente como hoje.

Agora é possível ocultar o identificador do item no Portal do Cliente por configuração, além do rótulo do campo ter ficado mais claro.

O que mudou:
- O campo passou a ser identificado como "ID Item", em vez de aparecer apenas como número
- A flag já vem habilitada, mantendo o comportamento atual para quem não fizer nada

Por que isso importa:
- O identificador interno não faz sentido para o cliente final e só polui a tela em operações que não usam esse número como referência
- Quem usa o identificador para se comunicar com o cliente continua com ele visível, sem precisar mudar nada
- O rótulo "ID Item" elimina a dúvida sobre a que aquele número se refere quando o cliente aciona o atendimento

Nenhuma ação é necessária para manter o comportamento atual. A configuração é por cliente e não altera nada em outras telas.