> 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-17-12-25.md).

# Release 17/12/25

As principais funcionalidades, estão destacadas com ⭐️

## Hyperflow Integrações

**Integrações - Novo módulo 'Tools'.**

* São blocos de funcionalidade externa que estendem as capacidades do seu Agente de IA. Elas permitem que o modelo de linguagem:
  1. Reconheça a Intenção: Identifique, a partir da entrada em linguagem natural do usuário, que precisa de uma funcionalidade específica (ex: verificar o clima, enviar um e-mail, buscar em um banco de dados).
  2. Determine Parâmetros: Gere o JSON de entrada com os parâmetros necessários para executar essa funcionalidade.
  3. Execução Externa: Entregue esse JSON ao seu fluxo para executar a ação.
  4. Processamento do Resultado: Receba o resultado da execução externa e o utilize para formular uma resposta final coerente ao usuário.
  5. Deve ser utilizado com o add-on de 'Assistente inteligente' da Hyperflow.
     1. A contratação é feita em: [Integracoes ](https://integracoes.hyperflow.global/)→ Cobranças e Assinaturas → Visualizar detalhes de consumo e contratar a nova funcionalidade em Add-Ons disponíveis.
* Os campos presentes no módulo de 'Tools' é:

  * Nome da ferramenta:
    * Um identificador único para esta ferramenta. Use apenas letras minúsculas, números e sublinhados. Espaços e caracteres especiais são removidos automaticamente.
    * Exemplos de nome:
      * `get_weather, send_email, search_database;`&#x20;
  * Descrição:
    * É crucial. A descrição é o texto que o modelo de IA lê para decidir quando e como usar a ferramenta.
  * Parâmetros (JSONSchema):
    * Define a estrutura de dados (JSON) que o modelo de IA deve gerar como entrada para sua função externa.

  <figure><img src="/files/R4XDgazXUT7lezwEsZJZ" alt=""><figcaption><p>Imagem 1 - Novo módulo disponível.</p></figcaption></figure>

{% hint style="danger" %}
**Observações importantes:**

* **Os nomes das ferramentas devem ser descritivos e seguir uma convenção de nomenclatura consistente (ex: snake\_case).**
* **A descrição é crucial—os assistentes de IA a usam para decidir quando chamar sua ferramenta.**
* **Use o gerador de IA para criar rapidamente definições de JSON Schema a partir de descrições em linguagem natural.**
* **Certifique-se de que seu JSON Schema é válido; schemas inválidos impedirão o registro da ferramenta.**
* **Inclua o array "required" para especificar quais parâmetros são obrigatórios.**
  {% endhint %}

**Integrações - Módulo Instagram**

* Adicionamos o m**ódulo do** [**Instagram**](https://help.hyperflow.global/docs/builder-de-chatbots/gatilho/instagram), permitindo iniciar fluxos automáticos a partir de interações dos usuários em **Stories, Posts, Reels e Lives**.

  Agora é possível:

  * Acionar fluxos automaticamente quando usuários **respondem Stories**, **comentam em Posts/Reels** ou **interagem em Lives**
  * Definir **palavras-chave** para iniciar automações e **palavras restritas** para bloquear acionamentos indevidos
  * Configurar automações para **conteúdos específicos** ou para **qualquer publicação**
  * Utilizar **Respostas Rápidas** em comentários de Posts e Reels para direcionar usuários ao privado ou à próxima etapa do fluxo
  * Gerenciar todas as automações do Instagram em uma **tela centralizada**, com edição feita diretamente no fluxo vinculado
* Essa funcionalidade amplia as possibilidades de **automação de atendimento, qualificação de leads e conversão**, diretamente a partir do engajamento no Instagram.

<figure><img src="/files/uhk4nWFlwCgHgOSabJAW" alt=""><figcaption><p>Imagem 2 - Ao selecionar canal do Instagram. podemos usar ações acima listadas.</p></figcaption></figure>

**Integrações - Módulo 'Google Gemini'**

* Agora é possível utilizar o [**Google Gemini**](https://help.hyperflow.global/docs/builder-de-chatbots/gatilho/google-gemini) **com Busca de Arquivos (RAG)** nos fluxos de automação.\
  O recurso permite que o Gemini consulte **documentos e pastas configuradas** antes de gerar respostas, entregando resultados mais **precisos, contextualizados e baseados em conteúdo próprio**.

  A funcionalidade inclui:

  * Integração direta com o **Google Gemini;**
  * Ativação da **Busca de Arquivos (RAG)** por nó;
  * Seleção de **pastas e documentos específicos** para consulta;
  * Opções avançadas de controle de resposta, como **tokens máximos** e **temperatura;**
* Essa novidade amplia o uso de IA nos fluxos, permitindo respostas fundamentadas em arquivos internos e regras do negócio.

**Integrações - 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 **Conversas**&#x20;

**Conversas - Novo modelo de assistente inteligente**

* Nesta atualização, lançamos uma nova feature de assistentes inteligentes.
* Após a contratação do add-on, acesse o [conversas](https://conversas.hyperflow.global), navegue até a aba **Agentes de IA** e clique em **Novo modelo de assistente** para iniciar a configuração.&#x20;

  <figure><img src="/files/u9zfFE13lunW4Fid3xOF" alt=""><figcaption><p>Imagem 2 - Botão 'Novo modelo de assistente'.</p></figcaption></figure>
* Na tela de criação, preencha os campos obrigatórios, selecione o modelo desejado (há múltiplas opções do **Gemini** e do **ChatGPT**) e, em seguida, informe o **prompt** que definirá o comportamento do assistente.&#x20;

  <figure><img src="/files/HzZ2GCc9H5OWS4LuFK2E" alt=""><figcaption><p>Imagem 3 - Criação do assistente inteligente.</p></figcaption></figure>

{% hint style="info" %}
**Observações importantes:**

* **As configurações acima foram básicas, simples e objetivas.**
* **Após a inserção do assistente, é possível editar alguns pontos como:**
  * **Tamanho que as mensagens serão divididas**
  * **Delay de mensagens**
  * **Temperatura**
  * **Tom de voz do assistente**
  * **Alteração do modelo usado**
  * **Alteração da versão do modelo também.**
    {% endhint %}

**Conversas - Novo filtro do 'Histórico de chats'**

* Nesta atualização, aprimoramos o filtro do histórico de chats, tornando as consultas mais precisas, rápidas e eficientes.&#x20;

  <figure><img src="/files/JOygd5JVKodpGRcZPFej" alt=""><figcaption><p>Imagem 4 - Novo filtro</p></figcaption></figure>
* Ao clicar no filtro, uma modal será aberta exibindo as opções de segmentação: **Gerais**, **Departamento**, **Agentes** e **Contatos**.&#x20;

  <figure><img src="/files/dy9wErW8IGDjVismQP77" alt=""><figcaption><p>Imagem 5 - Opções de filtragem geral, por agentes, departamentos ou contatos específicos</p></figcaption></figure>

{% hint style="info" %}

* Observações importantes sobre o uso dos filtros:
  * A busca específica por **contatos** estará disponível apenas dentro do filtro. A busca externa permanece funcionando por proximidade às palavras digitadas, quando realizada pelo nome do contato.
  * Ao selecionar filtros de forma combinada, será necessário clicar em **Aplicar** para efetivar a busca.
  * Após aplicar os filtros e preencher os campos corretamente, será possível remover filtros individualmente, mantendo os demais ativos.
    {% endhint %}

<figure><img src="/files/NVcm94F0Q4UPGQovLwEr" alt=""><figcaption><p>Imagem 6 – Exemplo de pesquisa por contatos específicos e remoção individual dos filtros aplicados.</p></figcaption></figure>

**Conversas - 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.
