Iniciar sessãoIniciar teste gratuito
Meta Tech Provider

O número aparece como Pendente ou Offline após a ligação

No WhatsApp Manager, Offline é o estado normal de um número da app WhatsApp Business antes de aderir à Cloud API, e não diz nada sobre elegibilidade. Após uma ligação Coexistence, a verificação da Meta é is_on_biz_app true e platform_type CLOUD_API, e só o estado connected permite enviar e receber. Se o número continuar Pendente ou Offline, leia esses campos antes de voltar a ligar.

O easyCoexistence monitoriza cada número ligado 24 horas por dia, regista os motivos de desligação da Meta na cronologia e permite que a sua própria IA leia o estado em tempo real com get_number_health.

connected

A Meta exige que um número de telefone empresarial tenha o estado connected para enviar e receber mensagens pela API.

PENDING

Um dos estados de ligação listados pela API de números de telefone da Meta, juntamente com CONNECTED, DISCONNECTED, FLAGGED, RESTRICTED e RATE_LIMITED.

is_on_biz_app

Com platform_type CLOUD_API, o teste da Meta de que um número funciona com a Cloud API e com a app WhatsApp Business.

Skip

A Meta indica às plataformas que ignorem o registo do número para um número Coexistence, porque já está registado.

133010

O erro da Cloud API para um número associado a uma conta mas nunca registado.

BLOCKED

O valor can_send_message que o estado de saúde da Meta devolve quando um número falha um ou mais requisitos de mensagens.

Onde aparecem Pendente e Offline?

São etiquetas da Meta, mostradas em WhatsApp Manager > Números de telefone e refletidas no estado que a API da Meta devolve para o número. Não são etiquetas do easyCoexistence. O nosso painel tem as suas próprias: Ligado, Degradado, Desligado, Banido / restringido, Suspenso e Desconhecido, definidas pela nossa monitorização da qualidade, dos eventos de desligação e dos banimentos.

As duas vistas respondem a perguntas diferentes, por isso podem não coincidir durante algum tempo. O WhatsApp Manager mostra como a Meta classifica o número neste momento. O nosso painel mostra se a ligação está ativa e saudável e regista cada alteração na cronologia do número. Quando não coincidem, decidem os campos em tempo real descritos abaixo.

O Offline é normal antes de ligar?

Sim. Um número que existe apenas na app WhatsApp Business ainda não está na Cloud API, por isso, se o WhatsApp Manager o listar, pode mostrar Offline ou Offline / Unverified. Esse estado não bloqueia a Coexistência e não diz nada sobre elegibilidade; só o passo de ligação da Meta decide isso.

Não tente pô-lo online a partir do WhatsApp Manager, registando-o ou pedindo um código. Esse é o caminho de migração, que tira o número da app WhatsApp Business. A Coexistência liga o número através da janela de inscrição da Meta, com um QR code lido na app, e a Meta indica às plataformas que ignorem o registo nesse caso.

O que deve mostrar uma ligação concluída?

A Meta dá um teste preciso, e o telemóvel confirma-o em palavras simples. Se o WhatsApp Manager ainda mostrar a etiqueta antiga alguns minutos após a ligação, atualize a página antes de agir; os campos abaixo são a verificação fiável.

  • Campos da Meta no número: is_on_biz_app true e platform_type CLOUD_API.
  • Estado da Meta: connected, necessário para enviar e receber através da API.
  • No telemóvel: a app WhatsApp Business indica que o número está ligado à API.
  • Na app: Definições > Conta > Business Platform lista o fornecedor.

E se os campos mostrarem que saiu da app empresarial?

Então o número foi muito provavelmente verificado com um código por SMS ou por chamada de voz, em vez do QR code. Isso é o caminho de migração, não a Coexistência: o número sai da app WhatsApp Business (is_on_biz_app false), fica na Cloud API sem estar registado e o primeiro envio falha com o erro 133010. Verificámos um caso real a 19 de outubro de 2026.

Depois disso já não pode ser concluído como Coexistência. Há duas saídas, e ambas exigem a equipa do fornecedor: manter o número apenas na API, com o registo concluído, ou devolvê-lo à app e voltar a ligá-lo por QR code. Nunca peça um código na janela da Meta durante uma ligação Coexistence.

Offline ou Desligado semanas depois

Um número que funcionou e depois deixou de funcionar tem outra história. A Meta desliga um número Coexistence quando a app WhatsApp Business no telemóvel não é aberta durante cerca de 14 dias, indicado como PRIMARY_INACTIVITY num webhook account_update. Outros motivos que a Meta indica incluem um dispositivo associado não utilizado durante cerca de 30 dias, uma alteração do número no telemóvel e o número registado novamente noutro dispositivo.

No easyCoexistence, o painel mostra o número como Desligado com o motivo da Meta, e o titular recebe um e-mail. A correção para a inatividade é abrir a app nesse telemóvel, deixar sincronizar e depois voltar a ligar. As mensagens da API não contam como abrir a app.

Como verificar o estado em tempo real, diretamente ou através da sua IA?

Peça à sua IA que execute get_number_health, ou peça-lhe, em palavras simples, que verifique o estado do seu número WhatsApp. A ferramenta lê o instantâneo em tempo real que a Meta tem do número (estado, platform_type, is_on_biz_app e qualidade) e devolve os últimos 15 eventos da cronologia de monitorização. Um campo coexistence_link_ok resume se o número continua ligado à app. Em separado, o easyCoexistence lê o estado de saúde da Meta e envia um e-mail ao titular quando o envio passa a BLOCKED.

Part of a get_number_health result for a healthy Coexistence number (illustrative)
{
  "live_snapshot": {
    "status": "CONNECTED",
    "platform_type": "CLOUD_API",
    "is_on_biz_app": true,
    "quality_rating": "GREEN"
  },
  "coexistence_link_ok": true
}

Erros comuns

  • Registar o número no WhatsApp Manager para limpar o Offline antes de ligar. Esse é o caminho de migração, que tira o número da app WhatsApp Business.
  • Pedir um código por SMS ou por chamada de voz na janela da Meta. Uma ligação Coexistence usa o QR code lido na app.
  • Remover e voltar a ligar à primeira vista de Pendente, antes de ler is_on_biz_app e platform_type.
  • Ler a etiqueta do painel como estado da Meta. Vêm de verificações diferentes; decidem os campos em tempo real.
Fazer isto com a EasyCoexistence

O número continua na app WhatsApp Business, com as suas automações a funcionar através da API oficial da Meta. De US$ 9 a US$ 0,75 por número ligado por mês, descendo à medida que adiciona números, com os primeiros 3 dias gratuitos.

Perguntas frequentes

O número pode enviar enquanto mostrar Pendente?

A Meta exige o estado connected para enviar e receber através da API, por isso os envios pela API falham até lá. A app no telemóvel continua a funcionar.

Offline significa que o telemóvel está desligado?

Não por si só. A API não precisa de a app estar aberta em todos os momentos; o que a Meta exige é abrir a app nesse telemóvel pelo menos a cada 14 dias.

Porque mostra o painel Ligado enquanto o WhatsApp Manager mostra Pendente?

O painel marca um número como Ligado quando a Meta conclui o registo e depois acompanha a qualidade, as desligações e os banimentos. get_number_health lê diretamente o estado em tempo real da Meta.

As mensagens dos clientes continuam a chegar ao telemóvel?

Sim. A app WhatsApp Business continua a receber e a enviar no telemóvel, seja qual for o estado mostrado pela API.

Continue a ler

Pronto para começar?

Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.

Começar período experimental gratuito

Verificado em