# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.hyperflow.global/docs/novidades-release-notes/release-04-11-25.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.