Migração da API WhatsApp

Este guia explica como ligar à Quoting24 um número que já está ativo nas API oficiais do WhatsApp (WhatsApp Business Platform) noutro fornecedor, sem mudar o número.

A secção WhatsApp é visível apenas para administradores.

A ligação começa sempre no mesmo ponto da Quoting24: Configurações → WhatsApp → WhatsApp Business → Conectar. O botão Conectar abre o registo integrado da Meta (Embedded Signup). A partir daí, a Quoting24 passa a ser o fornecedor que recebe e envia as mensagens desse número. A modalidade prevista é a ligação às API oficiais, descrita em Visão geral do WhatsApp.

Qual o procedimento a seguir

A Meta tem duas formas de ligar um número que já é usado por outro fornecedor. Antes de clicar em Conectar, verifica o portefólio em Meta Business Suite → Configurações → Contas.

O que vês na Meta Business Suite	O que fazer
Contas do WhatsApp e Contas de mensagens (Messaging Accounts) em separado	Modelo atual: partilha a conta do WhatsApp com a Quoting24. O número fica onde está.
Apenas Contas do WhatsApp	Modelo anterior: migra o número com um código SMS ou de voz.

No modelo atual, a Meta recusa mover o número de uma conta para outra. Desligá-lo do fornecedor anterior não o liberta.

O que preparar

Acesso de administrador à Quoting24.
Acesso de administrador ao portefólio Meta (Business Manager) que possui o número, com o utilizador Facebook que vais usar na janela Conectar.
O número já registado nas API oficiais. Os números de teste gratuitos atribuídos pela Meta não podem ser migrados.
Possibilidade de receber um SMS ou uma chamada de voz nesse número, se a Meta pedir um código.

A migração do modelo anterior exige também:

nome de exibição já aprovado, sem um pedido de alteração de nome ainda aberto;
verificação em duas etapas (PIN) desativada no número, sem apagar o número nem fechar a conta. Se não tiveres acesso à conta WhatsApp, pede a desativação ao fornecedor atual.

Modelo atual: partilhar o número com a Quoting24

Usa este procedimento se na Meta Business Suite aparecerem Contas do WhatsApp e Contas de mensagens.

Deixa o número ativo no fornecedor atual até ao fim. Retirá-lo antes, com mensagens de clientes a chegar, interrompe a receção.

Na Quoting24, abre Configurações → WhatsApp.
Na linha WhatsApp Business, clica em Conectar e entra com o administrador do portefólio Meta.
Seleciona o número já registado no outro fornecedor. A Meta mostra-o na lista e não pede um código novo: o número já está registado.
A Meta propõe o portefólio e a conta WhatsApp desse número. Confirma a partilha com a Quoting24.
Introduz o nome de exibição do número e continua. A Meta pode voltar a analisá-lo depois da ativação.
Revê as permissões pedidas (conta WhatsApp, conta de mensagens e recursos associados) e confirma.
Fecha a janela da Meta. Na Quoting24, a linha WhatsApp Business fica conectada.

A Meta cria uma conta de mensagens nova para a Quoting24, sob a mesma conta WhatsApp. O fornecedor anterior permanece ligado até o removeres.

Fazer as mensagens chegar à Quoting24

A partilha, por si só, não move as mensagens recebidas. Enquanto o fornecedor anterior continuar como parceiro, a Meta pode continuar a entregá-las a ele.

Quando a linha WhatsApp Business na Quoting24 está conectada:

Na Meta Business Suite, abre Configurações → Contas → Contas de mensagens, seleciona a conta, vai a Partners e remove o acesso da app do fornecedor anterior.
Abre Configurações → Contas → Contas do WhatsApp, seleciona a conta do número, vai a Partners e remove também aí o acesso do mesmo fornecedor.
Na mesma conta WhatsApp, abre Encaminhamento de conversas (Conversation routing) e atribui à Quoting24 cada tipo de conversa.

Na lista de parceiros pode aparecer o nome da app Meta ligada à Quoting24, e não o texto «Quoting24». Se não for claro qual o acesso a remover, para e pede ajuda ao suporte da Quoting24 antes de remover um parceiro.

Quando resta um único parceiro, a Meta desativa o encaminhamento e entrega as mensagens a esse parceiro.

O que se mantém neste modelo

Mantêm-se no número, porque a conta WhatsApp não muda:

número de telefone
nome de exibição
classificação de qualidade
limites de mensagens
estado de Official Business Account, se já estava ativo

Os templates pertencem à conta de mensagens, não ao número. A conta criada para a Quoting24 nasce vazia: os templates do fornecedor anterior têm de ser recriados na Quoting24 e aprovados de novo pela Meta.

Até estarem aprovados:

a partir da Quoting24 só podes responder livremente nas 24 horas seguintes à última mensagem do cliente;
em Broadcast API não há modelos para selecionar.

As conversas guardadas no software anterior não entram nos tickets da Quoting24. As mensagens que chegam depois da ligação tornam-se tickets. As conversas que já estão no telefone do cliente permanecem na app WhatsApp do cliente.

Modelo anterior: migrar o número

Usa este procedimento apenas se na Meta Business Suite aparecer somente Contas do WhatsApp.

Desativa a verificação em duas etapas

Pede ao fornecedor atual para desativar o PIN do número, ou fá-lo tu a partir do portefólio Meta, se tiveres acesso.

O número e a conta devem permanecer ativos. Só se remove a verificação em duas etapas.

Liga o número a partir da Quoting24

Na Quoting24, abre Configurações → WhatsApp.
Na linha WhatsApp Business, clica em Conectar e entra como administrador do portefólio Meta.
Escolhe criar uma nova conta WhatsApp. É o passo com que a Meta move o número que já existe: não é um segundo número.
Introduz o mesmo nome de exibição já aprovado nesse número.
Introduz o mesmo número. A Meta avisa que já está registado numa conta WhatsApp Business ou noutro fornecedor.
Pede o código por SMS ou chamada de voz e introduz-o.
Conclui os passos que faltam na janela da Meta.

A mudança costuma terminar em poucos minutos. Na Quoting24, a linha WhatsApp Business passa a conectada. Durante a passagem, a receção pode interromper-se durante alguns minutos.

O que se mantém e o que é preciso refazer

Mantêm-se no número:

nome de exibição
classificação de qualidade
estado de Official Business Account
limites de mensagens

Têm de ser refeitos na Quoting24:

os templates, que devem ser reenviados e novamente aprovados pela Meta antes de escrever fora da janela de 24 horas e antes de usar Broadcast API;
as campanhas do fornecedor anterior;
o histórico de chat desse software, que não é importado. As mensagens novas chegam como tickets.

Número já em coexistência com outro fornecedor

Se o mesmo número for usado em conjunto pela app WhatsApp Business e pelas API noutro fornecedor, a ligação API não volta a ligar sozinha a app no telefone.

Faz uma cópia de segurança das conversas na app WhatsApp Business.
Regista o mesmo número na app WhatsApp pessoal: o número sai da app Business.
Regista-o de novo na app WhatsApp Business.
Na Quoting24, clica em Conectar em WhatsApp Business e conclui a coexistência descrita em WhatsApp Coexistence: na app, Configurações → Dispositivos conectados → Conectar dispositivo, e depois lê o QR mostrado pela Quoting24.

Para levar o número só para as API, sem a app no telefone, usa o procedimento do modelo Meta que verificaste acima.

Depois da ligação

As mensagens novas do número tornam-se tickets na Quoting24.
Fora das 24 horas desde a última mensagem do cliente, escreve-se com um template aprovado. As regras do canal oficial estão em Visão geral do WhatsApp.
As campanhas criam-se em Broadcast API quando os templates estão disponíveis na Quoting24.
Para usar também a app WhatsApp Business no mesmo número é precisa a WhatsApp Coexistence.
Os grupos e as listas broadcast da app não passam para as API.

Se o procedimento parar

A Meta recusa mover o número. O portefólio está no modelo atual: volta à partilha e deixa o número registado no fornecedor anterior até a Quoting24 aparecer como conectada.
O código SMS ou de voz não chega. No modelo anterior, a verificação em duas etapas ainda está ativa. Desativa-a e repete Conectar.
O nome de exibição bloqueia a migração anterior. A Meta aceita a passagem só com o nome aprovado e sem uma alteração de nome pendente.
A Quoting24 está conectada, mas as mensagens não chegam. No modelo atual, o encaminhamento ainda aponta para o fornecedor anterior. Verifica Partners e Encaminhamento de conversas antes de desligar o número.
Se o parceiro a remover não for reconhecível, contacta o suporte da Quoting24 com o número e o ID do portefólio Meta.