Tema
Migrar do QR Code para a API oficial do WhatsApp sem perder as conversas
Muita empresa começa no QR Code porque é rápido: lê o código, conecta e atende. Com o tempo, o volume cresce, a operação passa a depender do número, e a API oficial da Meta começa a fazer sentido. Até agora, a troca tinha um custo escondido: criar outro conector, com as conversas antigas de um lado e as novas do outro, e refazer fluxos, sigilo e relatórios em cima do conector novo.
Desde 22 de outubro, isso acabou. O botão Migrar para API Oficial, no card do conector por QR Code, converte o mesmo conector para a conexão pela Meta.
O que continua ligado
Como o conector é o mesmo, continua tudo onde estava:
- as conversas e o histórico de mensagens;
- os fluxos que filtram por aquele número;
- o sigilo por time e a visibilidade do número (exclusivo de um time, por exemplo);
- o responsável padrão pelos negócios do funil;
- os relatórios, que seguem contando o mesmo conector;
- os modelos da Meta, que passam a valer para ele.
Não é preciso reimportar nada nem refazer configuração.
Por que migrar
- Sem sessão de QR Code para cair. Na API oficial, o número não depende de um aparelho conectado como dispositivo. É o fim do fim de semana sem atendimento porque a sessão caiu.
- Modelos e formulários. Modelos aprovados pela Meta, para iniciar conversa e retomar cliente parado, e os Formulários do WhatsApp, que o cliente preenche sem sair da conversa. Os dois estão explicados em Modelos da Meta e Formulários do WhatsApp.
- Conexão oficial em poucos cliques. O Columba é Tech Provider da Meta, e a conexão é feita pelo botão Conectar com a Meta, sem copiar credencial.
- Dá para manter o aplicativo. Na coexistência, o número continua no aplicativo WhatsApp Business do celular.
Antes de migrar: o que muda
Leia esta lista com calma. Nenhum item é um problema, mas todos pedem uma decisão antes:
- Janela de 24 horas para todas as conversas, inclusive as antigas. Um cliente parado há mais de um dia só recebe modelo aprovado até responder.
- Campanhas e aniversários só com modelo da Meta. Campanha agendada com texto livre precisa ser pausada ou ajustada antes da migração.
- Grupos de WhatsApp deixam de funcionar pelo Columba. A API oficial não tem grupos. As conversas de grupo daquele conector são encerradas e ficam como histórico.
- Mensagens antigas não podem ser citadas. Responder citando ou reagindo a uma mensagem anterior à migração não funciona, porque os identificadores do QR Code são diferentes dos da Meta.
- A Meta cobra. Modelos são cobrados a cada envio, e as respostas, a partir da 1.001ª do mês por número. A Meta exige um cartão cadastrado na conta do WhatsApp Business. Valores em A Meta passa a cobrar cada resposta.
- Não há botão de volta. Se um dia precisar voltar ao QR Code, é pelo suporte.
Coexistência ou número novo?
Na migração, você escolhe o que acontece com o número no celular:
| Coexistência (padrão) | Tirar o número do celular | |
|---|---|---|
| O número no celular | Continua no aplicativo WhatsApp Business | Sai do aplicativo e passa a existir só na Meta |
| Responder pelo celular | Possível, e quem responde pelo app assume a conversa | Não; tudo sai pelo Columba |
| Grupos, chamadas, catálogo e Status | Continuam, só pelo aplicativo | Indisponíveis: a API oficial não tem acesso a eles |
| Requisito | Número no WhatsApp Business (não no WhatsApp comum), com o app atualizado | Receber o código de verificação da Meta, por SMS ou ligação |
Na coexistência, os aparelhos vinculados ao número, como o WhatsApp Web, são desconectados quando ela é ativada, e o aplicativo precisa ser aberto de tempos em tempos para a ligação com a API não expirar. Se o número está no WhatsApp comum, migre-o para o WhatsApp Business dentro do próprio aplicativo antes, ou escolha tirar o número do celular.
Sobre o que acontece quando alguém responde pelo aplicativo, veja Respondeu pelo celular? A IA para.
Passo a passo
- Em Configurações › Conectores, no card do conector por QR Code, clique em Migrar para API Oficial. O botão aparece em qualquer status, inclusive com o conector desconectado ou bloqueado.
- Leia o resumo do que muda e escolha como fica o número: manter no aplicativo WhatsApp Business ou tirar do celular.
- Clique em Conectar com a Meta e, no popup, escolha o mesmo número do conector. Se for outro número, a migração é recusada antes de qualquer alteração.
- Pronto. O card passa a mostrar "Migrado do QR Code", com a data, e a checklist Saúde do número abre em seguida.
No fim da migração, a sessão por QR Code é encerrada, e o Columba aparece como dispositivo desconectado no celular. Se o servidor da sessão antiga não responder na hora, o card avisa e o Columba tenta encerrá-la de novo a cada hora, sem precisar de nada seu: as mensagens já chegam pela Meta.
Na coexistência, o Columba sincroniza os contatos do aplicativo, mas não importa o histórico de conversas da Meta. As conversas já estão no Columba, e importar de novo deixaria tudo em dobro. A checklist mostra "Histórico: mantido do QR Code".
E se eu tentar pelo caminho errado?
Quem cria uma instância nova, escolhe API Oficial e clica em Conectar com a Meta com um número que já está num conector por QR Code recebe a recusa: o Columba não cria um segundo conector para o mesmo número e aponta o conector existente. É de propósito. Dois conectores para um número separariam as conversas do mesmo cliente. Use o botão Migrar para API Oficial do conector que já existe.
A primeira semana depois da migração
- Saúde do número: confira pagamento, nome de exibição e verificação da empresa. Sem verificação, a Meta limita o envio a 250 contatos novos por dia.
- Modelos de Utilidade: crie pelo menos um para retomar o atendimento com quem ficou fora da janela.
- Campanhas e aniversários: troque o texto livre por modelos aprovados.
- Equipe: combine quem pode responder pelo aplicativo e quando.
- Consumo: acompanhe a linha "Este mês" no card do conector, que estima o que a Meta está cobrando e mostra a franquia de respostas.
O guia completo está em Migrar um conector QR Code para a API Oficial.
A migração está disponível para todo conector por QR Code no Columba. Ainda não usa? Teste por 7 dias sem cobrança.
