Ligar o WhatsApp ao SendApp Agent com a Cloud API oficial

A ligação é feita através do Meta Embedded Signup, o procedimento oficial da Cloud API: não é um código QR e não tens de copiar nem colar qualquer token. Começas no SendApp e depois o popup oficial da Meta guia-te até ao número ativo. Aqui estão todos os passos, com os ecrãs reais.

Coexistência: também podes ligar um número que já usas na app do WhatsApp Business. No modo coexistência o número funciona ao mesmo tempo na app e na API, sem recomeçar do zero (ver mais abaixo). Nesse caso, no passo 6 escolhe ligar a app existente em vez de um número novo.

1. 1

   Inicia a ligação no SendApp

   No SendApp vai a Aplicações → WhatsApp Meta, seleciona a conta (o bot de IA) à qual ligar o número e clica em «Ligar conta».

   
2. 2

   Confirma o teu perfil da Meta

   Abre-se o popup oficial da Meta: confirma que é o teu perfil e clica em «Continuar como…».

   
3. 3

   Concede as autorizações

   A Meta mostra as autorizações que vais partilhar com o SendApp para gerir o WhatsApp: clica em «Continuar».

   
4. 4

   Seleciona o portefólio empresarial

   Escolhe o teu portefólio empresarial na lista. Não tens nenhum? Vê mais abaixo, na secção «Não tens um portefólio empresarial?».

   
5. 5

   Confirma os dados do portefólio

   A designação social e o site preenchem-se sozinhos com base no portefólio escolhido: confirma-os e clica em «Seguinte».

   
6. 6

   Escolhe como ligar o número

   Escolhe «Começar com um novo número de telefone do WhatsApp». Em alternativa, para a coexistência, liga aqui o número que já usas na app do WhatsApp Business.

   
7. 7

   Cria a conta do WhatsApp Business

   Deixa selecionado «Criar uma conta do WhatsApp Business» e «Criar um novo perfil», depois clica em «Seguinte».

   
8. 8

   Configura o perfil da empresa

   Dá um nome à conta, define o nome de exibição (tem de corresponder à designação social) e escolhe a categoria da atividade.

   
9. 9

   Adiciona o número de telefone

   Escolhe «Adicionar um novo número»: a verificação do número é obrigatória.

   
10. 10

    Recebe o código de verificação

    Introduz o número com o indicativo (+351, +55, …) e escolhe «SMS» (ou chamada, se for um fixo).

    
11. 11

    Introduz o código de 6 dígitos

    Escreve o código recebido por SMS para confirmar o número.

    
12. 12

    Ligação concluída

    Pronto! Clica em «Concluir»: voltas ao SendApp com o número ativo e as conversas começam a chegar ao Chat, onde a IA pode responder.

    

Alguns ecrãs do popup podem aparecer em inglês: a interface segue o idioma da tua conta da Meta, mas os passos são idênticos aos descritos aqui. Os ecrãs oficiais (sempre atualizados) estão documentados pela Meta no fluxo oficial do Embedded Signup.

Não tens um portefólio empresarial? Cria-se na hora

Se no passo 4 não aparecer nenhum portefólio na lista, escolhe «Criar um portefólio empresarial» no menu: basta a designação social, um email da empresa e um site. Também o podes criar antes a partir do Business Manager da Meta.

Um número por conta: ligar um segundo número à mesma conta substitui o primeiro. Para gerir vários números do WhatsApp, cria uma conta separada para cada um (vê o guia «Operadores e permissões» e as FAQ mais abaixo).

A verificação da empresa é um passo importante para usar o WhatsApp sem limites apertados: a Meta exige-a para subir os limites (para além das ~250 novas conversas por dia do nível inicial) e para obter o selo de verificação. Faz-se no Business Manager da Meta, não no SendApp.

1. 1

   Inicia a verificação no Centro de segurança

   Em Business Manager → Definições → Centro de segurança encontras «Verificação da empresa»: clica em «Iniciar verificação».

   
2. 2

   Preenche o formulário e carrega um documento

   A Meta pede os dados da empresa e um documento (certidão comercial, certificado de IVA ou uma fatura): clica em «Iniciar» e segue o procedimento.

   

O selo de verificação (desde 2024 é azul, já não verde: a Meta unificou a verificação com o Facebook e o Instagram) e a verificação da empresa pedem-se e gerem-se na Meta, não no SendApp, e dependem da aprovação da Meta. Vê a página oficial sobre contas empresariais verificadas.

Com a coexistência ligas à API um número que já usas na app do WhatsApp Business e continuas a usá-lo em ambos: a app permanece ativa e, ao mesmo tempo, as mensagens recebidas também são geridas pelo SendApp, onde a IA pode responder. É a forma mais cómoda de passar para a API oficial sem recomeçar do zero.

O que é preciso

App do WhatsApp Business atualizada para uma versão recente, número adicionado ao Business Manager da Meta e abrir a app pelo menos uma vez a cada 14 dias para manter a ligação ativa.

O que sincroniza

As mensagens recebidas e enviadas em tempo real. Também as mensagens que envias pela app aparecem no SendApp, como cópia apenas de leitura.

O que é importado (uma vez)

Ao ligar, se escolheres «Partilhar conversas», a Meta importa os teus contactos e os últimos 6 meses de histórico. As conversas mais antigas não são importadas; para carregar mais contactos em massa usa a [importação por CSV](/pt/guia/importare-contatti-csv/).

Como ativar a coexistência, passo a passo

No passo 6 do Embedded Signup, em vez de «Começar com um novo número», escolhe «Ligar a tua app do WhatsApp Business existente». Depois segue estes passos (os ecrãs do popup podem aparecer em inglês, mas os passos são idênticos):

1. 1

   Introduz o número já ativo na app

   Seleciona o país e introduz o número que já usas na app do WhatsApp Business, depois clica em «Seguinte».

   
2. 2

   Mantém o código QR aberto

   A Meta mostra um código QR e avisa que serão partilhados o teu perfil, os contactos e os últimos 6 meses de histórico de conversas. Deixa este ecrã aberto no computador: vais precisar dele num instante.

   
3. 3

   Abre a mensagem do Facebook Business no telemóvel

   No telemóvel, na app do WhatsApp Business, recebes uma mensagem da conta oficial «Facebook Business»: abre-a e toca em «Digitalizar o código QR». Se não a vires, vai a Definições → Conta → Plataforma Business.

   
4. 4

   Escolhe se partilhas o histórico e digitaliza

   Escolhe se «Partilhar conversas» (importa os últimos 6 meses de conversas) ou não — esta escolha não pode ser alterada depois — e depois aponta o telemóvel ao QR mostrado no computador para concluir a ligação.

   

Na coexistência algumas ações passam para o SendApp: as campanhas e os envios em massa são enviados a partir da plataforma (não da app), e nas conversas 1:1 ficam desativadas algumas funções da app (editar e eliminar mensagens, mensagens temporárias e de visualização única, localização em tempo real). As mensagens que envias pela app continuam gratuitas e não consomem os limites da API.

Ligar o número é gratuito, mas para enviar os templates do WhatsApp é preciso um cartão associado à conta do WhatsApp Business na Meta: sem método de pagamento, os templates ficam «enviados» mas não são entregues. O cartão adiciona-se no Business Manager da Meta, não no SendApp.

1. 1

   Abre Métodos de pagamento no Business Manager

   Vai a business.facebook.com/billing_hub com a conta que gere a WABA e abre o menu «Métodos de pagamento».

   
2. 2

   Passa ao separador Contas do WhatsApp Business

   Na página de faturação seleciona o separador «Contas do WhatsApp Business».

   
3. 3

   Seleciona a tua conta do WhatsApp

   Escolhe a tua conta do WhatsApp no menu suspenso no canto superior direito.

   
4. 4

   Adiciona o método de pagamento

   Clica em «Adicionar método de pagamento». São precisos papéis de Administrador ou Finanças no Business Manager.

   
5. 5

   Introduz os dados do cartão

   Confirma país e moeda, escolhe «Cartão de débito ou de crédito» e continua com os dados do cartão (número, validade, CVC e nome). A Meta pode fazer uma pequena verificação temporária, depois reembolsada.

   

Usa um cartão (Visa ou Mastercard) ativado para pagamentos internacionais e online. Nunca introduzas os dados do cartão dentro do SendApp ou num email: introduzem-se apenas no site oficial da Meta.

Os templates não são entregues (Meta)

Muitas vezes falta o método de pagamento no número/WABA: os templates de marketing ficam num único visto («enviado», nunca «entregue»). Adiciona um cartão no Business Manager da Meta.

A ligação com a Meta não é concluída

Confirma que geres o WhatsApp Business com a conta da Meta utilizada e que o número não está já ativo noutra app do WhatsApp Business. Os passos do lado da Meta estão explicados no Centro de ajuda da Meta.