> ## Documentation Index
> Fetch the complete documentation index at: https://docs.messagefy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Transferência de Canal

> Mova um canal de WhatsApp entre Accounts da mesma Organization sem perder a sessão.

# Transferência de Canal

A operação de transferência move um canal de WhatsApp (e seu canal de feedback associado) para
outra *Account* dentro da **mesma *Organization***. Os dispositivos vinculados ao canal são
automaticamente atualizados para operar na nova *Account*, **preservando a sessão do WhatsApp** —
você não precisa reescanear o QR Code nem reautenticar.

## Casos de uso

* **Reorganização interna entre departamentos** — mover um número de *Vendas* para *Suporte* ao
  redesenhar a estrutura de atendimento.
* **Consolidação de canais** — agrupar canais que estavam dispersos em várias *Accounts* sob uma
  *Account* centralizada (ex: operação multi-marca migrando para uma *Account* unificada).
* **Modelo de software house** — mover um canal entre *Accounts* que representam clientes
  diferentes quando ocorrem mudanças contratuais.

## O que é preservado

* **Sessão do WhatsApp** — a vinculação no celular permanece ativa; nenhum QR Code/Pair Code novo
  é necessário.
* **Histórico de mensagens** — todas as mensagens já trocadas continuam acessíveis.
* **Configurações do canal** — webhook URL, *feedback channel*, parâmetros do provedor.
* **Outbox associado** — entradas pendentes/históricas permanecem disponíveis para inspeção e
  reenvio.

## O que muda

* **`accountId`** — o canal passa a pertencer à *Account* de destino.
* **API Keys** — chaves da *Account* de origem **deixam de ter acesso** ao canal; chaves da
  *Account* de destino **passam a ter** acesso.
* **Métricas e relatórios** — as métricas anteriores ficam associadas ao histórico da *Account*
  original; novas mensagens contam para a *Account* de destino.

<Warning>
  **A transferência só funciona entre *Accounts* da mesma *Organization*.** Para mover um canal
  entre *Organizations* diferentes não existe endpoint — você precisa deletar e recriar o canal,
  perdendo a sessão atual e exigindo nova autenticação.
</Warning>

## Antes de transferir

<AccordionGroup>
  <Accordion title="Confirme que a Account de destino existe e está ativa">
    Use o endpoint [`GET /api/v1/Admin/Account/{id}`](/api-reference/obter-conta) para validar.
    Transferência para *Account* inexistente ou desativada falha com `400 Bad Request`.
  </Accordion>

  <Accordion title="Atualize as integrações que usam API Keys da Account de origem">
    Após a transferência, chaves antigas perdem acesso ao canal. Garanta que as aplicações que
    enviam mensagens por esse canal já estejam usando chaves da *Account* de destino — caso
    contrário elas vão começar a receber `401 Unauthorized`.
  </Accordion>

  <Accordion title="Avise quem consome o webhook do canal">
    O webhook URL e o *feedback channel* não mudam, mas os eventos passam a ser contabilizados na
    nova *Account*. Se seu sistema correlaciona eventos por `accountId`, ele precisa lidar com a
    mudança.
  </Accordion>
</AccordionGroup>

## Endpoint

<Card title="Transferir canal" icon="arrow-right-arrow-left" href="/api-reference/transferir-canal">
  Documentação completa do endpoint, com payload, exemplos e respostas.
</Card>