Central de Ajuda › Conectar sua loja
Escolher o método de integração
Webhook, API Push, API Pull, sincronização agendada ou planilha. Qual serve para a sua loja e o que muda entre eles.
Integrar é ensinar sua loja a avisar o Folhear quando uma venda é confirmada. Existem cinco caminhos, e todos terminam no mesmo lugar: o livro na biblioteca do comprador. Muda só quem dá o primeiro passo.
| Método | Quem avisa quem | Quando usar |
|---|---|---|
| Webhook | Sua loja chama o Folhear | Loja Integrada, Shopify, WooCommerce — o caminho mais comum |
| API Push | Seu sistema envia a venda | ERP próprio ou integração sob medida |
| API Pull | O Folhear consulta sua loja | Plataformas que não disparam webhook |
| Sincronização agendada | O Folhear consulta de tempos em tempos | Volume baixo, sem urgência de segundos |
| Planilha (CSV) | Você sobe o arquivo | Migração de histórico, operação manual, contingência |
Qual escolher
Se sua loja oferece webhook, use webhook: é o único em que a entrega acontece em segundos sem ninguém fazer nada. A planilha não é um plano inferior — é o que permite começar hoje, sem esperar credencial de plataforma nenhuma, e continua útil depois como contingência.
Credenciais
Cada editora tem as suas: uma chave de API e um segredo de webhook, gerados no portal. É a credencial que identifica você — não é preciso enviar nome nem CNPJ em cada venda. A chave completa aparece uma única vez, no momento em que é criada; depois disso o Folhear guarda apenas o resumo criptográfico dela.
Dá para testar antes de valer. Na tela de Integrações, o botão de testar conexão faz uma chamada real e mostra o resultado — você confirma que está tudo certo antes da primeira venda de verdade passar por ali.