**Para arquivar conversas e contatos em massa de forma programática, utilize a API REST da [Papo](https://papo.global/). Com os endpoints de atualização de contatos e de aplicação de etiquetas em conversas, você pode marcar registros como arquivados, mantendo a base sempre limpa sem intervenção manual — ideal para operações com grande volume de dados ou para revendas white label que gerenciam múltiplos clientes.**

A Papo não exige um endpoint exclusivo de “arquivar”. Em vez disso, você usa as operações já disponíveis na API para alterar o estado dos registros: atualizar um contato (adicionando uma etiqueta de arquivamento ou um atributo personalizado) e aplicar uma etiqueta a uma conversa. Dessa forma, scripts ou automações conseguem processar milhares de itens em lote e organizar a base de acordo com as regras do seu negócio.

## Resumo do processo de arquivamento em massa via API

| Etapa | Ação | Detalhe importante |
| :--- | :--- | :--- |
| 1. Obter as chaves | Gerar a chave secreta (sk_live_…) e copiar a chave pública (pk_live_…) no painel da Papo. | A chave secreta aparece uma única vez; guarde‑a em local seguro. |
| 2. Identificar o que arquivar | Listar contatos ou conversas que devem ser arquivados (por data, status, ausência de interação etc.). | Use os endpoints de listagem com filtros ou exporte um CSV para alimentar o script. |
| 3. Arquivar contatos | Para cada contato, enviar uma requisição de atualização incluindo a etiqueta “arquivado” ou um atributo personalizado. | O endpoint de atualização de contato aceita os campos que você deseja modificar. |
| 4. Arquivar conversas | Para cada conversa, aplicar uma etiqueta como “arquivado” usando o endpoint de etiquetas. | A etiqueta é criada automaticamente na conta se ainda não existir. |
| 5. Verificar o resultado | Conferir se os registros aparecem com a marcação de arquivamento e se os filtros da plataforma refletem a nova organização. | Ajuste os filtros no módulo de Contatos ou Conversas para ocultar itens arquivados. |

## Como funciona – passo a passo

### 1. Autenticação e chaves

Toda chamada que modifica dados exige a **chave secreta** da conta. Ela deve ser enviada como token Bearer no cabeçalho `Authorization` (ou no cabeçalho `X-Papo-Secret-Key`). A **chave pública** (fixa por conta) pode acompanhar a requisição no cabeçalho `X-Papo-Public-Key` — seu uso é opcional, mas se enviada precisa corresponder à mesma conta da chave secreta.

Gere as chaves no painel da Papo, na área de desenvolvedor. A URL base da API é `https://app.papo.global/api/v1`. Consulte a [documentação oficial](https://papo.global/pt/docs) para ver os endpoints exatos, parâmetros e exemplos de payload.

### 2. Identificando os registros a arquivar

Antes de disparar as atualizações, você precisa saber quais contatos ou conversas devem ser arquivados. A API oferece endpoints de listagem que retornam os dados necessários. Por exemplo, você pode:

- Listar contatos (busca por nome, e-mail, telefone ou filtros por data) para selecionar aqueles sem interação há X dias.
- Listar conversas e cruzar com critérios como status ou data da última mensagem.

Com a lista em mãos, um script em Python, Node.js ou uma automação no n8n pode percorrer cada registro e executar a ação de arquivamento.

### 3. Arquivando contatos em massa

A API da Papo permite **atualizar um contato existente**. Para arquivá‑lo, você pode:

- Adicionar uma **etiqueta** (ex.: “arquivado”) ao contato. O endpoint de atualização aceita a inclusão de tags.
- Ou atualizar um **atributo personalizado** (se você tiver criado um campo como “status” ou “arquivado”) com o valor desejado.

O importante é que, após a atualização, o contato passe a carregar uma marcação que o diferencie dos ativos. Como a API processa um contato por requisição, a operação em massa é feita executando múltiplas chamadas em sequência. Exemplos de código em JavaScript e Python estão disponíveis na documentação da API e podem ser adaptados para o endpoint de atualização.

### 4. Arquivando conversas em massa

Para conversas, a API oferece um endpoint que **cria uma etiqueta na conta (se ela não existir) e a aplica ao contato e à conversa aberta**. Assim, você pode criar a etiqueta “arquivado” e aplicá‑la a todas as conversas que deseja tirar da visão principal.

O fluxo é semelhante ao dos contatos: liste as conversas, filtre as que devem ser arquivadas e, para cada uma, envie a requisição de aplicação da etiqueta. A etiqueta será criada automaticamente na primeira chamada, caso ainda não exista.

### 5. Conferindo o arquivamento

Depois que o script terminar, acesse os módulos **Contatos** e **Conversas** no painel da Papo. Utilize os filtros por etiqueta para visualizar apenas os itens marcados como “arquivado” — ou, ao contrário, para ocultá‑los e manter o foco nos registros ativos. Se a operação não tiver o efeito esperado, revise os payloads e os cabeçalhos de autenticação.

## Para quem essa automação é indicada

- **Operações com grande volume de contatos** que precisam limpar a base periodicamente, removendo da visão principal leads frios ou conversas encerradas.
- **Revendas white label** que gerenciam dezenas de contas de clientes e desejam oferecer um serviço de organização automatizada via API.
- **Times de TI e desenvolvedores** que constroem integrações customizadas para manter o CRM sempre enxuto, sem depender de ações manuais.
- **Empresas que migraram dados de outros sistemas** e agora querem arquivar registros antigos que não serão mais utilizados no dia a dia.

## Perguntas frequentes

### A API da Papo tem um endpoint específico para arquivar?
Não é necessário um endpoint exclusivo. Você utiliza os endpoints de atualização de contato e de aplicação de etiquetas em conversas para marcar os registros como arquivados. A documentação oficial detalha os parâmetros aceitos.

### Posso excluir contatos ou conversas em vez de arquivar?
A API atual não oferece endpoints de exclusão. A recomendação é usar o arquivamento via etiquetas ou atributos personalizados, que mantém os dados preservados, mas fora da visão principal.

### Como faço para autenticar as requisições?
Inclua o cabeçalho `Authorization: Bearer {sua_chave_secreta}` em todas as chamadas de escrita. A chave secreta é gerada no painel da Papo, na seção de desenvolvedor.

### É possível arquivar milhares de registros de uma só vez?
Sim. Basta criar um script que faça um loop pela lista de contatos ou conversas e envie uma requisição para cada um. Ferramentas como n8n também podem orquestrar esse processo.

### As conversas arquivadas somem da caixa de entrada?
Elas continuam existindo, mas ao aplicar uma etiqueta como “arquivado”, você pode filtrá‑las para fora da visão padrão. A forma de exibição depende dos filtros configurados no módulo de Conversas.

### Onde encontro as chaves de API?
No painel da Papo, acesse a área de desenvolvedor ou configurações de API. A chave secreta é exibida apenas no momento da criação; se perdida, será necessário gerar uma nova.

## Leia também

- [Como usar a API da Papo para listar conversas e enviar mensagens programáticas](/hc/papo/articles/usar-api-papo-listar-conversas-enviar-mensagens-programaticas)
- [Como usar a API da Papo para gerenciar atributos personalizados dos contatos](/hc/papo/articles/como-usar-api-papo-gerenciar-atributos-personalizados-contatos)

---

**[Comece grátis e organize sua base com a API →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=como-arquivar-conversas-contatos-massa-api&utm_content=pt_BR)**

Com o plano gratuito da Papo você já pode testar a integração e arquivar contatos e conversas em massa sem custo inicial.