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 tem de copiar nem colar qualquer token. Comece no SendApp e depois o popup oficial da Meta te guia até ao número ativo. Aqui estão todos os passos, com as telas reais.

Coexistência: também pode ligar um número que já usa 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 o Aplicativos → WhatsApp Meta, seleciona a conta (o bot de IA) à qual ligar o número e clica em “Ligar conta”.

   
2. 2

   Confirme o seu perfil da Meta

   Abre-se o popup oficial da Meta: confirme que é o seu perfil e clica em “Continuar como…”.

   
3. 3

   Concede as autorizações

   A Meta mostra as autorizações que vai partilhar com o SendApp para gerenciar o WhatsApp: clique em “Continuar”.

   
4. 4

   Selecione o portefólio empresarial

   Escolha o seu portefólio empresarial na lista. Não tem nenhum? Veja mais abaixo, na seção “Não tem um portefólio empresarial?”.

   
5. 5

   Confirme os dados do portefólio

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

   
6. 6

   Escolha como ligar o número

   Escolha “Começar com um novo número de telefone do WhatsApp”. Em alternativa, para a coexistência, liga aqui o número que já usa na app do WhatsApp Business.

   
7. 7

   Crie a conta do WhatsApp Business

   Deixe selecionado “Criar uma conta do WhatsApp Business” e “Criar um novo perfil”, depois clica em “Seguinte”.

   
8. 8

   Configure 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

   Adicione o número de telefone

   Escolha “Adicionar um novo número”: a verificação do número é obrigatória.

   
10. 10

    Receba o código de verificação

    Digite o número com o código do país (+55, +351, …) e escolhe “SMS” (ou chamada, se for um fixo).

    
11. 11

    Digite o código de 6 dígitos

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

    
12. 12

    Ligação concluída

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

    

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

Não tem 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 pode 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 gerenciar 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 → Configurações → Centro de segurança encontra “Verificação da empresa”: clique em “Iniciar verificação”.

   
2. 2

   Preencha 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): clique 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 gerenciam-se na Meta, não no SendApp, e dependem da aprovação da Meta. Veja a página oficial sobre contas empresariais verificadas.

Com a coexistência liga à API um número que já usa 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 gerenciadas 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 envia pela app aparecem no SendApp, como cópia apenas de leitura.

O que é importado (uma vez)

Ao ligar, se escolher “Partilhar conversas”, a Meta importa os seus contatos e os últimos 6 meses de histórico. As conversas mais antigas não são importadas; para carregar mais contatos em massa usa a importação por 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 sua app do WhatsApp Business existente”. Depois segue estes passos (as telas do popup podem aparecer em inglês, mas os passos são idênticos):

1. 1

   Digite o número já ativo na app

   Selecione o país e introduz o número que já usa na app do WhatsApp Business, depois clica em “Seguinte”.

   
2. 2

   Mantenha o código QR aberto

   A Meta mostra um código QR e avisa que serão partilhados o seu perfil, os contatos e os últimos 6 meses de histórico de conversas. Deixe esta tela aberta no computador: vá precisar dele num instante.

   
3. 3

   Abra a mensagem do Facebook Business no celular

   No celular, na app do WhatsApp Business, recebe uma mensagem da conta oficial “Facebook Business”: abra-a e toca em “Digitalizar o código QR”. Se não a vir, vai a Configurações → Conta → Plataforma Business.

   
4. 4

   Escolha se partilhas o histórico e digitaliza

   Escolha 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 celular 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 envia 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

   Abra Métodos de pagamento no Business Manager

   Vá a business.facebook.com/billing_hub com a conta que gerencia a WABA e abre o menu “Métodos de pagamento”.

   
2. 2

   Passe ao separador Contas do WhatsApp Business

   Na página de faturamento seleciona o separador “Contas do WhatsApp Business”.

   
3. 3

   Selecione a sua conta do WhatsApp

   Escolha a sua conta do WhatsApp no menu suspenso no canto superior direito.

   
4. 4

   Adicione o método de pagamento

   Clique em “Adicionar método de pagamento”. São precisos papéis de Administrador ou Finanças no Business Manager.

   
5. 5

   Digite os dados do cartão

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

   

Use 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”). Adicione um cartão no Business Manager da Meta.

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

Confirme que gerencia 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.