WhatsApp API oficial

O WhatsApp API oficial liga o número da sua empresa ao Leadz pela API da própria Meta. Com ele você atende no Chat de conversas, envia templates aprovados, dispara para listas e usa funis e agentes de IA dentro das regras da Meta. Na tela, o cartão deste canal se chama WhatsApp Cloud.

#Antes de começar

• Seja administrador do workspace. Outros cargos veem o botão «Somente administradores».
• Tenha o login do Facebook de quem administra a conta empresarial da sua empresa na Meta. A conexão é feita com esse login, em uma janela da Meta.
• Escolha o número. Pode ser um número novo ou um número que já usa o app WhatsApp Business. Neste segundo caso o número continua funcionando no celular: deixe o aparelho por perto, com o app atualizado, para confirmar.
• Libere pop-ups para app.sparkleleadz.com e desligue bloqueadores de anúncio nessa página. A janela da Meta não abre com eles.
• Um número, um workspace. O mesmo número oficial não pode estar conectado em dois workspaces ao mesmo tempo.

#Conectar o número

As telas do passo 3 são da Meta e podem mudar. Se aparecer o aviso «Conexão Meta preparada. Clique novamente em «Conectar» para abrir a autorização.», basta clicar em Conectar de novo.

Para ligar mais números depois, abra Configurar contas no cartão e clique em Conectar números.

#O que você encontra depois de conectar

A janela Configurar WhatsApp tem quatro abas.

#Nome, número e foto

Cada número aparece com o nome verificado, o número e a foto do perfil do negócio que estão cadastrados na Meta. O Leadz só exibe esses dados; eles são definidos na Meta.

#Situação do número na Meta

Na aba Números conectados, cada número tem dois atalhos:

• O botão de atualizar, ao lado do selo, consulta o status na Meta naquele momento.
• Ver qualidade na Meta abre um quadro com Conexão com a Meta, Qualidade do número (Saudável, Atenção ou Crítica), Verificação do número, Permissão para enviar, Limite de mensagens e Nome de exibição. Quando há algo a resolver, o quadro traz a linha «Próximo passo».

O botão Capacidades da conta mostra o que a Meta liberou para a conta inteira: Enviar mensagens, Criar templates, Empresa verificada, Forma de pagamento e Conta aprovada.

#Regras que passam a valer

• Janela de 24 horas. Texto livre só para quem escreveu nas últimas 24 horas. Fora disso, só template. Veja Janela de 24 horas.
• Cobrança da Meta. Os envios são cobrados pela Meta, na forma de pagamento cadastrada na conta da sua empresa na Meta.
• Ligação renovada sozinha. O Leadz renova a autorização do número com a Meta em segundo plano. Se a renovação falhar, você recebe um aviso no sino de notificações.

#Pausar ou desconectar

Pausar: na aba Números conectados, desligue a chave do número. Ele continua conectado, mas para de receber no Chat de conversas até você ligar de novo.

Desconectar:

#Problemas comuns

«Pop-up da Meta bloqueado. Permita pop-ups para este site e tente novamente.»

O navegador barrou a janela da Meta. Libere pop-ups para app.sparkleleadz.com (ícone na barra de endereço) e clique em Conectar de novo.

«SDK da Meta indisponível. Desative bloqueadores para connect.facebook.net.»

Um bloqueador de anúncios ou de rastreamento impediu o carregamento da Meta. Desligue a extensão nesta página, recarregue e tente outra vez. O mesmo vale para «Não foi possível carregar o SDK da Meta.».

«Embedded Signup cancelado ou não autorizado.»

A janela da Meta foi fechada antes do fim, ou o login usado não tem permissão na conta empresarial. Refaça a conexão com o Facebook de quem administra a conta na Meta e vá até o último passo.

«Este número já está conectado em outro workspace…»

O número oficial só pode ficar em um workspace. Desconecte-o no outro workspace e conecte de novo aqui.

«O PIN de verificação em duas etapas deste número não corresponde ao PIN salvo pela Meta.»

O número tem um PIN de duas etapas diferente do esperado. No WhatsApp Manager da Meta, redefina a verificação em duas etapas do número e conecte de novo.

«A Meta não devolveu um número WhatsApp autorizado.»

Você concluiu a janela da Meta sem escolher um número. Refaça a conexão e selecione o número no passo em que a Meta pergunta.

«O número foi conectado, mas a Meta não aceitou o pedido de sincronização do app WhatsApp Business.»

Acontece com número que já usa o app no celular. Sem essa sincronização, a Meta desconecta o número em até 24 horas. Conecte o número de novo agora, com o celular por perto. Se o aviso voltar, fale com o suporte.

«A ligação desta conta WhatsApp expirou ou foi revogada na Meta. Reconecte o número em Integrações para voltar a enviar.»

A autorização do número com a Meta deixou de valer, por exemplo depois de troca de senha do Facebook ou de remoção do acesso na Meta. Abra Configurar contas, clique em Conectar números e refaça o login com o mesmo número.

A mensagem falhou com «A Meta não consegue entregar a este número (#131026)»

A Meta aceitou o envio e depois não entregou. As causas são três: o número não tem WhatsApp, usa uma versão antiga do app ou está errado. Quando o número é impossível (DDD que não existe, dígitos a mais), o Chat mostra a faixa Número inválido com o motivo. Corrija o telefone na ficha do contato.

«A conta não está elegível para enviar: problema de pagamento na Meta (#131042).»

A Meta bloqueou os envios por falta de forma de pagamento válida. Regularize o pagamento no Gerenciador de Negócios da Meta.

«A Meta travou o envio por limite de spam neste número (#131048)»

A qualidade do número caiu, em geral por bloqueios e denúncias de quem recebeu. Reduza o volume, revise a lista e o texto, e espere antes de disparar de novo.

#Veja também

• Templates do WhatsApp
• Janela de 24 horas
• Visão geral dos canais