> For the complete documentation index, see [llms.txt](https://ajuda.zdg.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/configuracoes-gerais/importar-historico-de-conversas.md).

# Importar histórico de conversas

{% hint style="info" %}
**Disponível para o perfil:** Administrador
{% endhint %}

A página de **Importar Histórico** é uma ferramenta de migração de dados que permite trazer conversas realizadas externamente no aplicativo **WhatsApp Business** para dentro do painel Z-PRO. Esta funcionalidade é ideal para empresas que acabaram de implantar o sistema e desejam manter a continuidade do histórico de relacionamento com seus clientes em um canal centralizado.

#### Como acessar a página

No menu lateral, clique em **Configurações**, selecione a aba **Gerais** e clique no subitem **Importar histórico**.

<figure><img src="/files/7sJqFRISZGKcoX9qAYYq" alt=""><figcaption></figcaption></figure>

***

#### Passo a passo para Importação

Para realizar o processo, você deve primeiro exportar a conversa desejada no seu aplicativo móvel (WhatsApp Business > Configurações > Conversas > Histórico de conversas > Exportar conversa) e salvar o arquivo **.zip** gerado.

**1. Selecionar o Canal de Destino**

No campo **Canal**, escolha em qual das suas Conexões ativas no Z-PRO essas mensagens serão associadas. O histórico aparecerá vinculado a este número no sistema.

**2. Definir o Contato**

Informe o **Número do contato** com quem a conversa foi realizada.

* **Formato:** Utilize apenas dígitos, incluindo DDI + DDD + Número (ex: 5511999999999).
* **Importante:** Se o contato ainda não existir na sua base do Z-PRO, o sistema criará um novo perfil automaticamente durante o processo.

**3. Upload do Arquivo .zip**

Clique no botão **Escolher arquivo .zip** e selecione o arquivo exportado do WhatsApp Business.

* O sistema aceita arquivos que contenham o arquivo `.txt` da conversa e, opcionalmente, os arquivos de mídia (fotos, áudios e vídeos).

**4. Finalizar Importação**

Após preencher os campos e carregar o arquivo, clique no botão **Importar histórico** no canto inferior direito. O sistema processará as mensagens e as distribuirá cronologicamente no chat do contato.

<figure><img src="/files/GmFpFRozymjqbX03a8Yw" alt=""><figcaption></figcaption></figure>

***

#### Detalhamento das Regras de Importação

Para garantir a organização e evitar conflitos com bots, o sistema aplica as seguintes regras automáticas aos dados importados:

* **Status do Ticket:** Todos os atendimentos criados via importação nascem com o status **"Fechado"**.
* **Marcador Visual:** As mensagens importadas recebem a tag interna **"imported"**, permitindo que a equipe identifique o que é histórico legado e o que é atendimento nativo do sistema.
* **Responsabilidade:** Os tickets importados não possuem um atendente humano atribuído inicialmente no histórico.

***

#### Avisos e precauções

{% hint style="warning" %}
**Mensagens importadas não disparam automações:** Para evitar disparos indevidos e poluição de dados, os tickets criados por este método **NÃO** acionam:

* ChatFlow ou Chatbots;
* Inteligência Artificial (IA);
* Webhooks externos ou integrações n8n;
* Notificações Push no navegador ou celular.
  {% endhint %}

{% hint style="info" %}
O tempo de processamento da importação pode variar de acordo com o tamanho do arquivo `.zip` e a quantidade de mídias contidas nele.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.zdg.com.br/configuracao-administrador/configuracoes-painel-admin/configuracoes-gerais/importar-historico-de-conversas.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.