Onboarding e liberação de uma loja¶
Este roteiro reúne cadastro, integrações e aceite. Não execute testes com efeitos externos sem autorização. Em HML, use recursos próprios de teste, nunca credenciais de produção.
Pré-requisitos¶
| Responsável | Preparação |
|---|---|
| Plataforma / superadministrador | App Meta, número central, SMTP e provedores de IA configurados no ambiente |
| Lojista ou responsável técnico | URL da loja, autorização WooCommerce, conta WhatsApp Business, plugins comerciais e telefone administrador |
| Operação | Domínio/callbacks corretos, versão publicada e acesso aos logs |
Não solicitar senhas pessoais quando autorização ou credenciais com escopo adequado resolvem a integração. Não colocar tokens em tickets. Permissões são validadas nas rotas; esconder um botão não substitui autorização.
1. Cadastro e acesso¶
No painel, acesse a área de lojistas/cadastro com perfil autorizado. Confira nome, e-mail, telefone com DDI/DDD e loja selecionada antes de alterar integrações. Valide convite, acesso e associação do usuário à loja. O identificador técnico é merchant_id.
2. Conexão WooCommerce¶
Use a autorização oferecida no onboarding ou cadastre credenciais pelo fluxo permitido. Confira domínio HTTPS e permissões REST necessárias. Chave somente de leitura não atende criação de pedidos/produtos.
Há provisionamento de webhooks: não exigir configuração manual no WordPress de todo lojista. Confirme, porém, que o provisionamento terminou e os eventos chegam. Callbacks antigos não são necessariamente removidos automaticamente. Não apague integrações de terceiros. Veja integrações externas.
3. WhatsApp Business¶
Conclua o fluxo de conexão e confira conta, número e loja associada. Valide template de checkout, Flow publicado, endpoint/chaves, inscrição do aplicativo e entrega real de eventos. Handshake de webhook não comprova o funcionamento completo.
Catálogo Meta é opcional. A busca de produtos do Flow depende do índice interno e não deve ser confundida com esse catálogo.
4. Sincronização e diagnóstico¶
Confira sincronização e indexação. Registro salvo ou tarefa enfileirada não significa importação concluída. Compare uma amostra de produtos publicados e variações entre WooCommerce e busca.
Comece o diagnóstico pelas Conexões básicas. Use Verificar individual para corrigir um item sem repetir os demais. Resultados anteriores continuam históricos.
Frete, pagamento e teste do administrador exigem confirmação: podem criar registros ou enviar mensagem real. Confira plugins, endereço, dimensões/peso e autorização para efeitos. Veja limites do healthcheck.
5. Aceite e liberação¶
- Login do lojista e loja correta no painel.
- Recebimento e resposta no número WhatsApp esperado.
- Busca com e sem resultado, incluindo variações.
- Carrinho, endereço e frete.
- Pedido/link de pagamento controlado, sem cobrança real não autorizada.
- Alteração de produto refletida no índice por evento.
- Convite/recuperação de senha com destinatário controlado.
O status comercial deve ser revisado por usuário autorizado. Healthcheck não ativa a loja nem substitui esse aceite. Registre data, versão, resultados, pendências e responsável sem expor dados pessoais. Falhas: diagnóstico por sintoma.