Principal Integração com WhatsApp FAQ — Integração com WhatsApp: perguntas frequentes

FAQ — Integração com WhatsApp: perguntas frequentes

Última atualização em May 07, 2026

Quando usar

  • Você tem uma dúvida pontual sobre integração de WhatsApp e quer resposta rápida
  • Você está em pré-onboarding e quer ter na mão respostas frequentes do time
  • Quer mapear caminhos alternativos antes de abrir um chamado de suporte

Sobre o número e a conta

Preciso de um chip físico ou celular para integrar?

Não necessariamente. Para a integração sem coexistência (API exclusiva), você não precisa de chip físico — pode usar um número virtual. Para a integração com coexistência, você precisa do celular com o WhatsApp Business App instalado no momento da configuração.

O que é um número virtual? Onde compro?

Um número virtual é um número de telefone que funciona sem chip físico, contratado online. O Cloud Chat recomenda a BR DID para quem precisa de um número virtual para usar na API.

Posso usar meu número pessoal de WhatsApp?

Não recomendamos. A WhatsApp Business API é voltada para números empresariais. Além disso, ao integrar sem coexistência, o número para de funcionar no app do celular — o que causaria problemas se for seu número pessoal.

Posso ter dois números de WhatsApp diferentes conectados no Cloud Chat?

Sim. Cada número fica em uma caixa de entrada separada. Por padrão, uma conta verificada pode ter até 20 números conectados.

Detalhes: Qual é o limite de números de WhatsApp conectados?

Posso conectar o mesmo número em duas ferramentas ao mesmo tempo (ex: Cloud Chat e outra plataforma)?

Não. Um número só pode estar conectado a um provedor de API por vez. Para migrar para o Cloud Chat, é necessário desconectar do provedor anterior primeiro.

Sobre a migração

Vou perder o histórico de mensagens ao migrar?

O histórico de mensagens do provedor anterior não é migrado automaticamente — fica acessível apenas na plataforma antiga. Se precisar importar tickets antigos, isso é possível via API do Cloud Chat: Import de histórico de tickets.

Em integração com coexistência, o histórico dos últimos 6 meses do WhatsApp Business App é sincronizado — mas apenas parcialmente, sem garantia de completude (limitação da Meta).

Meu provedor atual não quer liberar o número. O que faço?

Acione o time de suporte da Cloud Humans — existem caminhos alternativos que dependem de análise do caso. Antes, confirme: a WABA está no seu Business Portfolio Meta ou no portfólio do provedor? Se estiver no seu, você tem controle administrativo e pode migrar independentemente.

Preciso desativar o Two-Step Verification antes de migrar. Como faço se não sei a senha?

  • Se você é o dono da WABA → acesse o WhatsApp Manager e desative diretamente

  • Se o provedor anterior controla o Two-Step Verification → solicite a eles que desativem

Sem desativar o Two-Step Verification, a migração não é tecnicamente possível.

Sobre coexistência

O que é coexistência?

Coexistência é a funcionalidade da Meta que permite usar o mesmo número simultaneamente no celular (WhatsApp Business App) e na API oficial (Cloud Chat). Detalhes: O que é a coexistência no WhatsApp.

Se eu usar coexistência, o que acontece se o celular ficar sem bateria ou internet?

O Cloud Chat continua funcionando normalmente via API. A coexistência não depende do celular estar ativo.

Se alguém remover manualmente o Cloud Chat da lista de dispositivos conectados no app do celular, a integração será interrompida e precisará ser refeita.

Minhas mensagens do WhatsApp Desktop (Windows) não aparecem no Cloud Chat. Por quê?

O WhatsApp Desktop para Windows e o WhatsApp WearOS não são suportados pela Meta para espelhamento via API em modo coexistência. As mensagens ficam visíveis no celular, mas não geram webhook e por isso não chegam ao Cloud Chat. O WhatsApp Web (navegador) funciona normalmente.

Detalhes: Mensagens de WhatsApp não chegam ao Cloud Chat? Entenda a limitação da coexistência.

Posso usar grupos do WhatsApp no Cloud Chat?

Não. A API oficial da Meta não suporta grupos. Os grupos continuam visíveis apenas no celular (em modo coexistência), mas não aparecem no Cloud Chat.

Sobre templates e envios

O que são templates e quando preciso deles?

Templates são mensagens pré-aprovadas pela Meta, usadas para iniciar conversas com clientes ou para enviar mensagens após a janela de 24h de inatividade. Para respostas dentro de 24h após o último contato do cliente, você não precisa de template.

Por que meu template foi reprovado como Utility?

A Meta reclassifica templates de Utility para Marketing quando detecta linguagem promocional, falta de contexto transacional ou texto muito genérico. Para reverter:

  • Inclua identificador claro (número de pedido, ticket, protocolo)

  • Use linguagem objetiva

  • Remova qualquer tom comercial

Detalhes: Regras de templates do WhatsApp (Meta): categorias, estrutura e reprovações.

Por que não consigo enviar mensagens para muitos contatos de uma vez?

Provavelmente você atingiu o limite do seu tier de envio. Cada conta começa no Tier 1 (1.000 conversas/24h) e avança automaticamente conforme volume e qualidade crescem.

Detalhes: Tiers de envio do WhatsApp: o que são e como evoluir.

Troubleshooting rápido

O Cloud Chat parou de receber mensagens do WhatsApp. O que verificar?

  1. Verifique se a caixa de entrada está ativa em Configurações → Caixas de Entrada

  2. Se usar coexistência, verifique no celular se o Cloud Chat ainda aparece em Dispositivos Conectados

  3. Se o dispositivo foi removido, reconecte: Como reconectar sua inbox WhatsApp no Cloud Chat

  4. Se o problema persistir, acione o suporte

Minha mensagem aparece com erro. O que significa?

Consulte o guia completo com causas e ações para cada código: Por que minha mensagem não está sendo enviada? Guia Completo de Erros.

Observações