O Codewo conecta WhatsApp por duas vias: a API oficial Meta (Cloud) e uma conexão via WhatsApp Web. As duas funcionam — escolher a certa depende de volume, exigências regulatórias e tolerância a risco.
O que é
- WhatsApp Cloud API — Integração oficial da Meta. Requer Business Manager, número verificado e aprovação. É o caminho recomendado pra qualquer operação séria.
- WhatsApp Web — Conexão não-oficial baseada em automação do WhatsApp Web do navegador. Você scaneia QR code com o celular, e o Codewo passa a enviar/receber pelo seu número.
Ambas chegam no mesmo Inbox unificado. A diferença é onde a mensagem nasce e o que cada via permite.
WhatsApp Cloud API
API oficial da Meta. Pensado pra uso comercial em escala.
Vantagens:
- Oficial — sem risco de bloqueio por uso comercial.
- Templates HSM — Mensagens proativas (você fala com o cliente sem ele ter falado primeiro) só funcionam via template aprovado pela Meta.
- CTWA (Click-to-WhatsApp Ads) — Anúncio do Meta Ads que abre conversa no WhatsApp captura o
ctwa_clidautomaticamente, fechando o loop de atribuição. - Múltiplos números no mesmo Business Account.
- Suporte oficial da Meta.
Limitações:
- Janela de 24h — Depois que o cliente para de responder por 24h, você só pode falar com ele de novo usando template HSM aprovado. Mensagem livre fora dessa janela não passa.
- Custos por conversa — A Meta cobra por janela de 24h aberta. Modelo varia (utility, marketing, authentication, service). Consulte preço atual no painel da Meta — não é o Codewo que cobra, é a Meta.
- Setup mais elaborado — precisa de Business Manager, verificação do número, e às vezes documento da empresa.
WhatsApp Web
Conexão via WhatsApp Web do navegador, automatizada por trás. Você plugou e usou.
Vantagens:
- Zero burocracia inicial — Você cria o canal, scaneia o QR code com o celular do número, e em 30 segundos está atendendo.
- Conversa livre sem janela 24h — Você pode mandar mensagem quando quiser. Não tem template HSM.
- Funciona com número pessoal — Útil pra MVPs, demos, equipes pequenas, ou quando você quer testar antes de investir em Cloud.
Limitações:
- Não-oficial. WhatsApp pode banir o número — Especialmente se o uso parecer abusivo (muitos envios em massa, contas reportadas). Não há recurso oficial caso isso aconteça.
- Sem CTWA — Anúncios Meta Ads não passam o
ctwa_clidpor essa via. Atribuição de leads via anúncio fica capenga. - Sem templates HSM — Marketing em massa fica fora de cogitação.
- Sessão cai — Periodicamente você precisa reescanear o QR (celular reinicia, perde conexão, etc.). Tem alertas automáticos, mas é manutenção.
- Sem suporte oficial.
Qual escolher?
| Cenário | Recomendação |
|---|---|
| Operação estabelecida, volume médio/alto | Cloud |
| Faz campanha no Meta Ads com Click-to-WhatsApp | Cloud (sem ele, atribuição quebra) |
| Manda broadcast de marketing/promoção | Cloud (HSM é o único caminho legal) |
| MVP, demo pra cliente, número pessoal compartilhado | Web |
| Não tem CNPJ ainda ou ainda não pode abrir Business Manager | Web (temporariamente) |
| Operação regulada (banco, saúde, jurídico) | Cloud (compliance só funciona via oficial) |
Posso ter os dois?
Sim. São canais separados no Codewo — você liga os dois e cada um é tratado individualmente. O mesmo contato (mesmo telefone) que chegou pelos dois é unificado: você vê todas as conversas dele no histórico do contato, independente de qual canal.
Use-os juntos quando faz sentido — por exemplo, número Cloud pra entrada principal (campanhas, broadcasts) + número Web do gerente pra atendimento próximo a clientes VIP.
Pegadinhas comuns
- Migrar Web → Cloud não é instantâneo. Cloud exige verificação do número (telefone fica indisponível durante o processo, minutos a horas). Programe a migração fora de horário comercial.
- Banimento do Web é silencioso. O número vai parar de receber mensagens sem aviso prévio do Codewo — é o WhatsApp que cortou. Quando perceber sumiço, primeiro tente reconectar o QR; se o celular avisar "banido", não tem o que fazer pelo Codewo.
- Templates HSM precisam ser aprovados. Você cria o template no painel da Meta ou via Codewo, e ele entra em fila de aprovação (24–72h). Não dá pra "criar e mandar agora".
- Custo Cloud surpreende. Marketing em escala (broadcast pra milhares) pode gerar fatura significativa da Meta. Simule custos antes de campanha grande.
- Mesma equipe atendendo número Cloud e Web confunde o cliente. Você responde de um número diferente do que ele tentou contato. Use o mesmo número quando possível, ou explique no histórico.
Boas práticas
- Comece pelo Web se você ainda não tem Business Manager configurado — funciona pra validar o produto.
- Migre pro Cloud assim que volume passar de ~100 conversas/mês ou quando precisar de anúncios CTWA.
- Reserve um número oficial pra Cloud — não use número pessoal de funcionário. Se a pessoa sair, o número fica.
- Cadastre templates HSM cedo — Aprovação leva tempo. Tenha pelo menos 1 template de notificação ("seu pedido foi enviado") aprovado antes de precisar.