A WhatsApp API é a conexão oficial do WhatsApp para empresas, direta com a Meta. É a mais estável, a que habilita todas as funções (campanhas em massa, modelos, medição de anúncios) e a recomendada para operar de verdade.
Como conectar
- Acesse Canais e no cartão WhatsApp API clique em Conectar (há um botão Tutorial com o guia em vídeo).
- Abre-se a janela oficial da Meta: faça login com o Facebook e escolha (ou cadastre) sua conta do WhatsApp Business e seu número.
- Siga os passos — o botão mostra o progresso: Conectando… → Processando… → Salvando conexão… → Conectado ✔.
- Ao terminar você verá o aviso "Conexão estabelecida!".
💡 Número novo ou o que você já usa? Ambos funcionam. Se você já usa o número no app do WhatsApp Business, pode conectá-lo sem deixar de usar o celular: as mensagens que você responder pelo app também ficam registradas no WeSpeak.
ℹ️ Se mais adiante a conexão com a Meta for perdida (troca de senha, permissões vencidas), o sistema detecta automaticamente e envia uma notificação de canal desconectado — você não depende de perceber por conta própria.
Os status do seu número
No cartão do canal você vê três indicadores:
| Indicador | O que significa |
|---|---|
| Status da conexão | Conectado / Pendente (falta concluir a verificação) / Desconectado (ver o detalhe abaixo). |
| Nome comercial | A Meta revisa o nome visível do seu negócio: Aprovado, Em revisão ou Rejeitado. |
| Limite de mensagens | Mostrado como "N conversas/dia": quantas conversas você pode iniciar por dia fora da janela de 24 horas. Responder a clientes que escreveram para você não consome esse limite nem tem teto. Ele só sobe se você mantiver boa qualidade. |
Todos os status de conexão possíveis
| Status | O que significa |
|---|---|
| Conectado | Seu número está conectado e operando normalmente. |
| Pendente | O número foi adicionado à conta do WhatsApp Business, mas ainda não concluiu o processo de configuração/verificação. Conclua a verificação na Meta. |
| Desconectado | O número perdeu a conexão com o WhatsApp. Reconecte-o em Canais. |
| Excluído | O número não está mais disponível na conta do WhatsApp Business (foi removido pela Meta). |
| Banido | A Meta suspendeu o número. Verifique o status da conta no Meta Business Suite (veja o guia de Problemas com o WhatsApp). |
O nome comercial, além de Aprovado, Em revisão e Rejeitado, pode aparecer como Nome Expirado (o certificado venceu: solicite-o novamente na Meta) ou Nome inexistente (falta validar o nome no Meta Business Suite).
A regra das 24 horas (o mais importante)
O WhatsApp permite escrever livremente durante as 24 horas posteriores à última mensagem do cliente. Passado esse prazo (ou para iniciar uma conversa nova), você só pode enviar modelos aprovados pela Meta:
- No chat, digite / para escolher um modelo.
- Só aparecem selecionáveis os modelos com status Aprovado.
- Se tentar enviar texto livre fora da janela, o sistema avisa: "Você deve usar um modelo para enviar esta mensagem."
- Cada mensagem que você enviar fora da janela precisa do seu próprio modelo, até que o cliente responda.
- Quando o cliente responde, a janela reabre na hora e você volta a escrever livremente (sem recarregar a página). Ela também fecha com precisão: exatamente 24 horas após a última mensagem do cliente, mesmo que o chat esteja aberto.
O que oferece
| Função | WhatsApp API |
|---|---|
| Texto, emojis, anexos, notas de voz | ✅ |
| Modelos aprovados (com /) | ✅ |
| Citar / responder uma mensagem | ✅ |
| Agendar mensagens | ✅ |
| Campanhas em massa | ✅ (o canal recomendado) |
| Vários números ao mesmo tempo, com nome e padrão ⭐ | ✅ |
| Texto livre depois de 24 h sem resposta do cliente | ❌ Somente modelos aprovados |
| Excluir mensagens | ⚠️ Somente mensagens do contato e somente do seu painel (o contato continua vendo) |
Perguntas frequentes
Por que não consigo escrever para um cliente que me falou na semana passada?
Passaram mais de 24 h desde a última mensagem dele: use um modelo aprovado (digite /).
Meu nome comercial está "Em revisão", posso operar?
Sim, o envio de mensagens funciona; a Meta aprova o nome em paralelo.
Posso ter a WhatsApp API e a conexão por QR Code ao mesmo tempo?
Não — são excludentes. Para conectar a API, primeiro desconecta-se o QR: em Canais, o cartão do WhatsApp QR tem o botão Desconectar ao lado do check de status. Confirme na caixa de diálogo e pronto — você não precisa contatar o suporte. Lembre-se de que, para voltar a usar a conexão por QR, você terá que escanear o código novamente (não é preciso reinserir o número).
Se eu migrar de QR para API, perco o histórico de conversas?
Não necessariamente: seu consultor pode executar uma migração do histórico para o novo canal, que transfere as conversas, todas as mensagens (enviadas e recebidas) e as notas de cada conversa. Se já existia uma conversa com o mesmo contato no destino, elas são mescladas automaticamente.
Minha conexão é "híbrida" ou API pura? O que significa?
Híbrida = seu número está vinculado à API da Meta, mas continua utilizável pelo telefone (o app convive com a plataforma). API pura = o número vive só na API: você não usa mais o app do WhatsApp e tudo é respondido pelo WeSpeak. Se ao conectar um telefone os demais dispositivos foram desconectados, é um efeito de como a Meta gerencia as sessões nesse esquema — consulte seu consultor antes de mover o número.
O que preciso para migrar de QR para API? Perco algo?
Você precisa do usuário e senha da Meta do negócio (e dos do Facebook/Instagram se for vinculá-los) e remover a conta do WhatsApp Business do telefone. Você não perde a linha: a API só assume o envio de mensagens do WhatsApp — o número de telefone e as chamadas continuam funcionando normalmente. O que muda: você deixa de usar o app e responde tudo pela plataforma.
Posso publicar "status" do WhatsApp pelo WeSpeak?
Não — os status são uma função do app e não estão disponíveis via API.
Quero um QR para um folheto que abra um chat com meu número.
Dá para fazer: é um QR que aponta para o seu número com uma mensagem predefinida. Peça ao seu consultor (não é uma gestão do painel).
Como consigo o selo verde (conta verificada)?
Quem concede é a Meta, não o WeSpeak. Requisitos habituais: 30 dias ou mais usando o WhatsApp Business, cumprimento das políticas da Meta e notoriedade do negócio. É solicitado pelo seu Meta Business Suite (a verificação do Instagram é um trâmite à parte).
Meu telefone também tem o app do WhatsApp Business e responde sozinho.
Desative as mensagens de boas-vindas, de ausência e respostas rápidas do app (WhatsApp Business → Configurações → Ferramentas comerciais): elas se sobrepõem ao assistente.