Conectando o WhatsApp Business à plataforma

4 min de leitura

Nesse tutorial iremos ensinar como conectar o seu número WhatsApp Business à plataforma ApexPlus, possibilitando o envio automático de confirmações de consultas e o atendimento aos seus pacientes diretamente pelo sistema.

A integração da ApexPlus utiliza o fluxo oficial da Meta (Embedded Signup) e o nosso provedor oficial é o ISP Provider — DeployCode, que faz a intermediação entre a sua conta Meta Business e o ApexPlus.

O que você precisa antes de começar:

  • Permissão: O usuário deve ter a permissão de "Configurações do WhatsApp Business" em seu perfil de usuário.

  • Uma conta Meta Business verificada (CNPJ ou documento pessoal).

  • Um número de telefone válido no Brasil (fixo ou celular com DDD), capaz de receber SMS ou ligação para verificação.

  • Os dados do seu estabelecimento (nome, endereço, e-mail, segmento) que serão exibidos no perfil do WhatsApp Business.

  • Permissão de "Gerenciar WhatsApp" no seu usuário da plataforma. Caso o botão de integração não apareça, fale com o proprietário da conta para liberar o acesso.

Atenção sobre o número que será conectado: ao conectar um número que já é usado no aplicativo WhatsApp Business do celular, ele será migrado para a API e deixará de funcionar no aplicativo. Se você não quiser abrir mão do uso manual no celular, o ideal é adquirir uma linha dedicada (chip novo ou número virtual, como Claro Virtual ou Vivo Digital) exclusivamente para a integração com o ApexPlus.

Assista o tutorial de integração

O que o sistema faz após a conexão

Logo após o término do Embedded Signup, o ApexPlus executa três passos automaticamente — todos transparentes para você:

  • Registro do número na Cloud API — ativa o número para envio e recebimento de mensagens via API. É nesse momento que o sistema gera um PIN de 2FA de 6 dígitos que fica armazenado de forma criptografada na sua conta.

  • Submissão do template de confirmação de consultas — o ApexPlus envia automaticamente o template padrão de confirmação para aprovação da Meta. A análise costuma levar de minutos a algumas horas.

  • Inscrição em webhooks — o sistema passa a receber em tempo real os eventos de mensagens, status de entrega e atualizações do template e da conta.

Acompanhando o status da integração

A tela de integração mostra em tempo real o avanço do onboarding. Você não precisa atualizar a página — conforme a Meta confirma cada etapa, a tela atualiza sozinha.

  • Perfil da conta — exibe nome de exibição, número conectado, qualidade da conta (verde, amarela ou vermelha) e nível de mensageria.

  • Checklist de etapas — número validado → template enviado → template aprovado → conta ativa.

  • Alertas da Meta — qualquer aviso sobre suspensão, baixa qualidade ou revisão é exibido aqui.

Quando a conta fica ativa

  • Assim que o template de confirmação for aprovado pela Meta, o status muda para "Ativo" e as confirmações automáticas de consulta passam a ser enviadas conforme a sua agenda.

  • Se o template for rejeitado, você verá o motivo na tela e poderá desconectar e fazer uma nova integração para reenvio dos dados e/ou entrar em contato com nosso suporte.

Dúvidas frequentes

  • Perco meu histórico de conversas anteriores?

O histórico antigo do app no celular não é importado. Apenas as conversas que acontecerem após a conexão ficam registradas no ApexPlus.

  • Posso usar o mesmo número em duas contas?

Não. Um número só pode estar vinculado a uma conta — WhatsApp Business App ou Cloud API. A migração é exclusiva.

  • Existe risco de banimento?

A integração usa o fluxo oficial da Meta (Embedded Signup), o método recomendado por todos os provedores oficiais. Banimentos só ocorrem por comportamentos abusivos como disparo em massa.

  • Posso reconectar depois de desconectar?

Sim. Basta refazer o processo de "Conectar WhatsApp" a qualquer momento.

  • Quanto tempo leva para o template ser aprovado?

Normalmente entre 5 minutos e algumas horas. O ApexPlus envia automaticamente o template padrão após a conexão.