Skip to main content

​
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.
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.

​
Antes de transferir

Use o endpoint GET /api/v1/Admin/Account/{id} para validar. Transferência para Account inexistente ou desativada falha com 400 Bad Request.
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.
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.

​
Endpoint

Transferir canal

Documentação completa do endpoint, com payload, exemplos e respostas.