Credenciais de canal: o erro que me custou uma semana de pedidos
O roteiro do cadastro de contas de marketplace, das credenciais dinâmicas aos alertas de token expirado, com as regras por conta que definem o comportamento da sincronização.
Cadastrei as credenciais de canal numa terça à noite, com pressa, e marquei o ambiente como sandbox sem perceber. O teste de conexão passou. Os anúncios subiram. Durante seis dias nenhum pedido chegou ao ERP, e ninguém achou estranho, porque o canal era novo e a expectativa de volume era baixa. Na sexta seguinte encontrei 41 pedidos parados no painel do seller, três deles já fora do prazo de envio.
É por isso que este texto começa pelo campo mais chato de todos. Cada empresa pode manter várias contas por canal no WAHub. A conta guarda ambiente, URL base, identificador externo do seller, campos dinâmicos de credencial conforme o canal e um conjunto de regras que decide como aquela conta se comporta na sincronização.
Se você ainda não escolheu o canal, volte um passo e leia o catálogo de conectores e a cobertura por canal.
O que o hub guarda das credenciais de canal
Os campos são dinâmicos e mudam conforme o canal, porque cada plataforma pede um conjunto diferente de chaves, segredos, identificadores de aplicação e escopos. O hub mostra só o que interessa àquele canal, o que já elimina boa parte dos erros de digitação.
Os segredos ficam gravados criptografados, com prefixo próprio que identifica o conteúdo cifrado, e aparecem mascarados na tela. Ninguém recupera visualmente uma chave já salva, nem quem tem acesso à tela. Quando a chave muda, ela é substituída, não exibida. Isso incomoda no começo e agradece depois.
O cadastro, passo a passo
- Termine o credenciamento no canalConta de seller, aplicação e chaves saem do portal do parceiro. Sem isso, você abre o hub só para preencher metade do formulário.
- Crie a conta no hubEscolha o canal, dê um nome interno que faça sentido daqui a um ano, marque o ambiente e informe a URL base quando o canal pedir.
- Confira o identificador externo do sellerÉ esse campo que resolve a empresa correta quando um evento chega por webhook. Errou aqui, quebrou a associação.
- Preencha as credenciais dinâmicasComplete os campos exibidos para aquele canal. Eles variam conforme o modelo de autenticação da plataforma.
- Rode o teste de conexãoEle valida o acesso e guarda identificadores adicionais devolvidos pelo canal, reaproveitados nas chamadas seguintes.
- Ajuste as regras da contaSincronização de estoque, preço, pedidos, reserva e markup conforme a estratégia daquele canal, não a média da casa.
OAuth muda a natureza do problema
Canais com OAuth usam autorização delegada e renovação de tokens. Em vez de uma chave estática que você esquece na gaveta, passa a existir um ciclo de vida com validade. O hub cuida da renovação nas rotinas periódicas, e o comando de sincronização tem um modo dedicado a tokens.
Só que o token continua válido enquanto a autorização não for revogada no painel do canal. Revogação silenciosa acontece. Geralmente depois de troca de senha ou de mudança do responsável pela conta de seller. Já vi acontecer numa sexta-feira de véspera de feriado, que é quando essas coisas gostam de acontecer.
Alertas que não podem virar paisagem
- Conta com erro: alguma chamada autenticada está falhando de forma persistente
- Token expirado: a integração está parada até alguém reautorizar
- Token perto de expirar: sua janela para renovar sem ninguém sentir
- Pedidos aguardando importação acima do normal no painel
- Falhas finais da fila depois de esgotadas as tentativas
Esses avisos convivem no painel com contas conectadas, anúncios publicados, pedidos, receita e comissões dos últimos 30 dias. Tratar alerta de token como ruído é o caminho mais curto para perder venda, e o texto sobre fila de sincronização e política de tentativas mostra como o hub reage antes de desistir.
As regras ficam na conta, e isso é estratégia
Sincronização de estoque, preço, pedidos, reserva e markup são configurados por conta, não pelo sistema inteiro. Um canal com comissão maior pode trabalhar com markup diferente. Um canal com logística mais lenta pode carregar reserva maior. Você decide canal a canal.
| Regra | Para que serve | O que acontece se errar |
|---|---|---|
| Sincronizar estoque | Manter saldo coerente com o ERP | Venda sem lastro e cancelamento no canal |
| Sincronizar preço | Propagar tabela e reajuste | Anúncio vendendo abaixo do custo |
| Importar pedidos | Trazer a venda para o fluxo nativo | Pedido preso no canal, sem faturamento |
| Reserva | Segurar saldo para os outros canais | Ruptura artificial e perda de posição |
| Markup | Ajustar preço à comissão do canal | Margem corroída onde o canal é caro |
Restrinja quem edita conta
O sistema e os menus do hub estão ligados ao catálogo de permissões do ERP, com chaves granulares. Deixe a edição de contas com um grupo pequeno e dê ao time do dia a dia acesso de leitura sobre anúncios e pedidos. Para desenhar isso por perfil, veja gestão e permissões no ERP.
- Ambiente da conta conferido com alguém olhando junto
- Identificador externo do seller comparado com o painel do canal
- Teste de conexão executado com sucesso
- Regras de estoque, preço, reserva e markup revisadas
- Edição limitada aos responsáveis pela integração
- Rotina de renovação de token agendada e monitorada
Com a conta validada, o próximo passo é vincular catálogo e publicar. Antes disso, combine a estrutura de identificadores com o time de cadastro conforme governança de SKU e EAN no multicanal.