# Versão 2.16.0 — Atualização (Follow-up + Clara IA + Integrações)

### ⚠️ Atenção: Follow-up (mudança importante)

Agora você precisa **definir o horário permitido de envio** (janela de disparo).

#### O que mudou

* A **“Hora de início” não será mais usada**.
* O sistema passa a usar **o horário em que o túnel for adicionado** para validar o envio dentro da janela permitida.
* Se o envio calculado cair **fora do horário permitido**, ele é **adiado automaticamente** para o próximo horário válido.

#### Exemplo (janela 08:00 às 20:00)

* Se o envio calcular para **21:00**, ele será enviado **às 08:00 do próximo dia**.
* Se o envio calcular para **03:00**, ele será enviado **às 08:00 do mesmo dia**.

✅ Resultado prático: você evita envio fora de horário e mantém o follow-up “no tempo certo” sem precisar ficar ajustando manualmente.

***

### 📇 Envio de contato (novo)

Agora você pode enviar contato por:

* **API**
* **Typebot**
* **Bot Interno**

Isso facilita automações do tipo “salvar/compartilhar contato” sem gambiarras.

***

### 💬 Mensagens e organização por filas

* **Mensagens rápidas por fila**\
  Ideal para separar por setor (vendas, suporte, financeiro) e manter atalhos certos no lugar certo.
* **Mensagens rápidas com cores**\
  Ajuda muito na velocidade do time (atalhos críticos ficam “no olho”).
* **Mensagens de despedida por fila**\
  Para cada setor fechar atendimento com o tom e a orientação correta.

***

### 🤖 Clara IA e Integrações

#### Configuração de ausência de resposta

Quando o cliente não responde, você pode definir o que fazer:

* **Enviar para uma fila / usuário**, ou
* **Fechar o ticket**

#### Clara IA (novidades)

* **Follow-up por IA**
* **Regra de inatividade do cliente**
  * Executar automaticamente um **prompt específico**
  * Enviar mensagem para cliente inativo
  * (Opcional) Instruir a IA a **fechar o ticket**
* Ações automáticas:
  * Transferir para usuário
  * Adicionar etiqueta
  * Mudar etapa Kanban
  * Enviar chave Pix
* **Tempo mínimo e máximo entre respostas** (gera “tempo aleatório” entre mensagens)
* **Suporte Perplexity**
* **Suporte Tavily** para buscar em site específico por palavras-chave e enriquecer o prompt\
  (a API informa 1000 consultas/mês grátis — conforme política do provedor)
* **Criação de base de conhecimento** (em implantação)

***

### 🧠 GPT Assistant (mudança relevante)

Foi removida a opção de cadastrar novos **OpenAI GPT Assistant**.

* ❌ **Não será possível cadastrar novos**
* ✅ Os que já estão cadastrados **serão mantidos**

Motivo: a **Assistants API** foi descontinuada e tem data de desligamento informada pela OpenAI (26/08/2026).

📌 Recomendação: para novas automações e evolução, priorize a **Clara IA / integrações atuais**.

***

### 📅 Agendamento

* Nova opção de **repetição**:
  * Diário
  * Trimestral
  * Semestral
  * Anual
* Possibilidade de agendar para **até 5 contatos** no mesmo agendamento.

***

### 📞 Integração SIP

* Adicionada opção de **transferir chamada**.

***

### 🔄 Hub

* Melhoria na exibição de erros na consulta de **ACK** para mensagens com falha de entrega.

***

### ✅ Checklist rápido pós-atualização (recomendado)

1. Ajustar **janela de horário permitida** no Follow-up (08:00–20:00 ou sua regra)
2. Validar 2 cenários de follow-up: um envio “fora do horário” e um “madrugada”
3. Revisar configurações do **Webhook/N8N** (Base64 só se realmente precisar)
4. Organizar **Mensagens rápidas por fila** + definir cores
5. Configurar regra de **ausência de resposta** (fila/usuário ou fechar ticket)
6. Testar: envio de **contato** (API/Typebot/Bot interno) se você usa

***

### FAQ

**1) Por que a “hora de início” do follow-up parou de funcionar?**\
Porque agora o sistema valida pelo horário em que o túnel é adicionado e respeita a janela de envio. Se cair fora, ele agenda para o próximo horário permitido.

**2) Se o follow-up cair 21:00 (fora da janela), ele é perdido?**\
Não. Ele é **adiado automaticamente** para o próximo horário permitido (ex.: 08:00 do dia seguinte).

**3) Ativar JSON em Base64 melhora a integração?**\
Só em casos específicos. Em geral, Base64 **pesa mais** e pode travar fluxos com muitos arquivos. Use apenas quando seu N8N/serviço exigir.

**4) O que é `contactmessage` no webhook?**\
É um identificador para mensagens vindas de **grupos**, informando que um usuário mandou mensagem no grupo.

**5) Vou perder meus GPT Assistants antigos?**\
Não. Os já cadastrados ficam ativos, mas **não dá para criar novos**. (A OpenAI informou desligamento da Assistants API em 26/08/2026.)

**6) Mensagens rápidas por fila é obrigatório?**\
Não, mas melhora muito a operação quando você tem setores diferentes. Evita atalho errado no atendimento errado.


---

# 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://ajuda.super-zapp.com.br/extras/atualizacoes-do-sistema/versao-2.16.0-atualizacao-follow-up-+-clara-ia-+-integracoes.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.
