> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/novidades-release-notes/release-04-11-25.md).

# Release 04/11/25

As principais funcionalidades, estão destacadas com ⭐️

## Hyperflow Builder

**Builder - Usabilidade do módulo de 'Ativar usuário'.**

* Ao utilizar o módulo de 'Ativar usuário', a listagem antiga de canais não tinha a apresentação de 'Alias'. Agora, apresentamos normalmente para seleção assertiva de canal conforme o necessário.

<figure><img src="/files/jQIhIIOKmnrn8pbykum8" alt=""><figcaption><p>Imagem 1 - Apresentação de alias dos canais WebSDK configurados no módulo de 'Ativar usuário'.</p></figcaption></figure>

**Builder - Firebase Cloud Firestore — Operação QUERY**⭐️

* A operação **QUERY** permite consultar documentos dentro de uma coleção do **Firestore**, aplicando filtros, ordenações e limites de forma controlada.
* **Caminho do Objeto**
  * Define o caminho da coleção ou subcoleção onde a consulta será executada.
  * Esse campo é obrigatório, pois determina o local exato no Firestore onde a query será realizada.\
    Pode ser uma coleção simples (ex.: `clientes`) ou um caminho completo com subcoleção (ex.: `usuarios/rafael/atividades`).
* **Filtros**
  * Os filtros permitem restringir os resultados retornados pela query. Cada filtro é composto por três elementos: **Campo**, **Operador** e **Valor**.
  * **Operadores disponíveis:**
    * `==` : Retorna documentos em que o valor do campo é igual ao valor especificado.
    * `!=` : Retorna documentos em que o valor do campo é diferente do valor especificado.
    * `>` : Retorna documentos em que o valor do campo é maior que o valor especificado.
    * `<` : Retorna documentos em que o valor do campo é menor que o valor especificado.
    * `>=` : Retorna documentos em que o valor do campo é maior ou igual ao valor especificado.
    * `<=` : Retorna documentos em que o valor do campo é menor ou igual ao valor especificado.
    * `in` : Retorna documentos cujo campo contém um valor dentro de uma lista de valores informada.
    * `not-in` : Retorna documentos cujo campo não contém nenhum dos valores da lista.
    * `array-contains` : Retorna documentos em que o campo, sendo um array, contém o valor especificado.
    * `array-contains-any` : Retorna documentos em que o campo, sendo um array, contém pelo menos um dos valores listados.
  * É possível adicionar múltiplos filtros. Quando filtros e ordenações utilizam campos diferentes, o Firestore pode exigir a criação de **índices compostos**.
* **Ordenação**
  * Permite definir a ordem em que os documentos serão retornados.\
    São configurados dois campos:
    * **Campo:** atributo usado como base para a ordenação.
    * **Direção:** define se a ordenação será crescente ou decrescente.
  * Quando a ordenação é combinada com filtros, o Firestore pode solicitar a criação de um índice.
* **Paginação e Limite**
  * Controla a quantidade e a sequência dos resultados retornados.\
    Essa seção é útil para evitar consultas extensas e otimizar desempenho.
  * **Campos disponíveis:**
    * **Limite:** define a quantidade máxima de documentos que a consulta retornará.
    * **Limitar ao Último:** retorna os últimos documentos da consulta com base na ordenação aplicada.
    * **Começar Em:** inicia a consulta a partir de um valor ou documento específico, incluindo-o no resultado.
    * **Começar Após:** inicia a consulta após um valor ou documento específico, excluindo-o do resultado.
    * **Terminar Antes:** encerra a consulta antes do valor ou documento especificado.
    * **Terminar Em:** erra a consulta ao alcançar o valor ou documento especificado, incluindo-o no resulta

<figure><img src="/files/QarbahTqbwW3caPpWb1x" alt=""><figcaption><p>Vídeo 1 - Módulo Firebase (firestore - opção Query)</p></figcaption></figure>

**Builder - Novo layout do payments e inclusão do one click** ⭐️

* Atualizamos o layout do payments no módulo de 'Enviar mensagem' do Builder. E além disso, adicionamos a função de 'One click'.
* A funcionalidade **One-Click Payment** (ou “Pagamento com um clique”) é um recurso nativo da **API de Pagamentos do WhatsApp** que permite ao cliente **finalizar uma transação sem precisar reinserir seus dados de pagamento** em interações futuras.
* Em outras palavras, o **cliente autoriza um pagamento diretamente dentro da conversa**, utilizando um **método de pagamento salvo** (como cartão, Pix dinâmico ou conta digital vinculada).
* Isso reduz drasticamente a fricção no checkout e aumenta a taxa de conversão das transações realizadas pelo canal WhatsApp.
* **Como funciona**
  * **Primeira transação:**
    * O cliente realiza um pagamento completo dentro do WhatsApp (ex.: via Pix ou cartão).
    * Durante o processo, o WhatsApp/Meta **cria e armazena um token de pagamento seguro** associado àquele usuário (sob consentimento).
  * **Transações futuras (One-Click):**
    * Quando o cliente recebe um novo pedido ou link de pagamento, o WhatsApp identifica que ele já possui um **método de pagamento salvo**.
    * O cliente só precisa **confirmar o pagamento com um clique**, sem preencher novamente os dados.
  * **Autorização e confirmação:**
    * O fluxo é todo **nativo no WhatsApp**, sem redirecionamentos externos.
    * A autorização ocorre via **Meta Payments Gateway**, e o comerciante recebe um `payment_id` com status em tempo real via **webhook**.
  * **Benefícios**
    * **Checkout instantâneo:** reduz o tempo médio de conversão de 40s para menos de 10s.
    * **Maior conversão:** elimina abandonos de carrinho por redirecionamento.
    * **Segurança nativa:** dados do cliente ficam armazenados com a Meta (compliance PCI DSS).
    * **Experiência fluida:** tudo ocorre dentro da janela da conversa.&#x20;

<figure><img src="/files/6s5LKxeROl4tFEA3yGhL" alt=""><figcaption><p>Video 2 - Módulo de enviar mensagem -> Opções de 'Pedido e pagamento' e 'Status do pedido'.</p></figcaption></figure>

<figure><img src="/files/8DFWMl9l0Lh0q0GkEUyk" alt=""><figcaption><p>Imagem 2 - Exemplo de mensagem recebida no WhatsApp referente ao pagamento pendente.</p></figcaption></figure>

**Builder - Geral**&#x20;

* Nesta atualização, também foram feitas correções menores e otimizações visando manter a plataforma Hyperflow Builder sempre atualizada, segura, e o mais robusta possível.

## Hyperflow Desk&#x20;

**Desk - Ordenação na tela de 'Oportunidades'.**

* Nesta atualização, implementamos a funcionalidade de ordenar oportunidades de acordo com as opções:
  * Data de atualização;
  * Data de criação;
  * Ordem alfabética;
  * ID.

<figure><img src="/files/uLgkVYeEIm2Jq0zYovGQ" alt=""><figcaption><p>Imagem 3 - Ordenação da tela de 'Oportunidades'.</p></figcaption></figure>

**Desk - Edição dos campos adicionais ou padrões de 'Oportunidades'.** ⭐️

* Nesta atualização, foi adicionada um novo layout para edição dos campos padrões e personalizados por etapa das oportunidades.

<figure><img src="/files/pWQY9JcbCpzPkRCLi9nZ" alt=""><figcaption><p>Imagem 4 - Tela de edição de campos vinculados à etapas nas oportunidades.</p></figcaption></figure>

**Desk - Supervisor inteligente**

* Nesta atualização, adicionamos a funcionalidade de 'Supervisor inteligente'.
* Esse supervisor é cadastrado na tela de 'Agentes de IA', e a partir de alguns parâmetros pré-definidos por você, ele fará análises precisas dos atendimentos de um departamento previamente informado ao inserir esse supervisor.
* Obrigatoriamente deve-se informar um departamento pelo menos. Caso seja necessário selecionar todos os departamentos temos a opção 'Selecionar todos os departamentos' não podendo deixar o campo vazio.&#x20;
* Para criar o supervisor inteligente, devemos acessar a tela 'Agentes de IA', ir para aba de 'Supervisor inteligente' e clicar em 'Adicionar supervisor'.&#x20;

<figure><img src="/files/rF0BERjbdKjmYDKYuYMn" alt=""><figcaption><p>Imagem 5 - Tela de adição de supervisor.</p></figcaption></figure>

* Caso não tenha criado anteriormente nenhum parâmetro pode-se clicar em 'Criar parâmetro' que sera apresentado uma nova modal para cadastrar o parâmetro desejado.&#x20;

  <figure><img src="/files/32wYjMjlI5g0mB9bg3GR" alt=""><figcaption><p>Imagem 6 - Tela de adição de parâmetros.</p></figcaption></figure>
* A partir desses cadastros, teremos um supervisor cadastrado contendo os parâmetros que serão analisados a cada atendimento. Para poder visualizar as análises por protocolo feitas devemos acessar a tela de 'Histórico de chats', filtrar para o departamento que irão acontecer as análises, e clicar na ação de 'estrelas', conforme print:

  <figure><img src="/files/A3NNIozEwVjkZa9V6CD3" alt=""><figcaption><p>Imagem 7 - Análise de atendimento feito pelo supervisor inteligente.</p></figcaption></figure>

  <figure><img src="/files/8IFcL6UWq9P4FxALAtzU" alt=""><figcaption><p>Imagem 8 - Parâmetros previamente configurados no supervisor inteligente para análise.</p></figcaption></figure>

**Desk - Geral**

* Nesta atualização, também foram feitas correções menores e otimizações visando manter a plataforma Hyperflow Desk sempre atualizada, segura, e o mais robusta possível.