O que você vai montar
Com a Shopify conectada, os artigos gerados no ClickHunt são publicados direto no blog da sua loja, com capa, resumo, tags e autor. A conexão usa um app que você cria no Dev Dashboard da Shopify: ele gera um Client ID e um Client Secret, que você cola no ClickHunt. O ClickHunt renova o acesso sozinho a cada 24 horas.
Disponível a partir do plano Pro. Só o dono ou um administrador do projeto consegue configurar.
Desde janeiro de 2026, a Shopify não deixa mais criar apps novos pelo caminho antigo, em Configurações › Apps › Desenvolver apps. O caminho agora é o Dev Dashboard, descrito abaixo.
Antes de começar
- Acesso de dono ou de colaborador com permissão para apps na loja.
- Um blog criado na loja. No admin da Shopify, abra Loja virtual › Posts do blog (ou Conteúdo › Posts do blog, conforme a versão do admin), clique em Gerenciar blogs e crie um se ainda não houver. Sem blog, a conexão não fecha.
- O endereço
.myshopify.comda loja. Ele aparece em Configurações › Domínios, mesmo que a loja use um domínio próprio. Ex.:minha-loja.myshopify.com.
Passo 1: crie o app no Dev Dashboard
- Entre em dev.shopify.com/dashboard com a mesma conta que administra a loja. Se você tem mais de uma organização, escolha a organização dona da loja.
- Clique em Apps e depois em Create app.
- Dê um nome, por exemplo
ClickHunt, e confirme.
Passo 2: dê a permissão de publicar conteúdo
- Dentro do app, abra a aba Versions e crie uma versão nova.
- Em Access scopes, adicione o escopo
write_content. É ele que permite criar e atualizar artigos do blog. - Clique em Release para lançar a versão.
Passo 3: instale o app na loja
- Ainda no app, clique em Install app (ou Home › Install app).
- Escolha a sua loja e confirme a instalação.
Esse passo é o mais esquecido. Sem o app instalado na loja, a Shopify recusa as credenciais.
Passo 4: copie o Client ID e o Client Secret
- No app, abra Settings e procure a seção Credentials (ou API credentials).
- Copie o Client ID.
- Copie o Client Secret. Guarde num lugar seguro.
Passo 5: cole no ClickHunt
- No projeto, abra Configurações › Integrações, seção Hospedagem.
- No card Shopify, clique no ícone de engrenagem (Configurar).
- Preencha:
- Domínio da loja: o endereço
.myshopify.com, não o domínio próprio. Ex.:minha-loja.myshopify.com. - Client ID: copiado no passo 4.
- Client Secret: copiado no passo 4.
- Domínio da loja: o endereço
- Clique em Conectar. O status fica Verificando e depois passa para Pronto para ativar.
- Para os próximos artigos irem para a Shopify, clique no botão principal Conectar do card e confirme em Conectar o Shopify?. O card passa para Conectado.
O que vai para a Shopify
- Texto, capa e resumo. A capa vai como imagem do artigo, com o texto alternativo.
- Tags. Vão junto com o artigo.
- Autor. A Shopify exige um autor. Se o artigo não tiver um, sai com o nome da loja.
- Data de publicação. Respeita a data do ClickHunt.
- Endereço. O artigo fica em
sua-loja.myshopify.com/blogs/<nome-do-blog>/<artigo>, e também no seu domínio próprio, se a loja tiver um.
Mais de um blog na loja? O ClickHunt publica no primeiro blog da loja. Se você precisa que vá para outro, fale com o suporte.
Mensagens de erro
| Mensagem | O que fazer |
|---|---|
| A Shopify recusou estas credenciais | Quase sempre o app não foi instalado na loja (passo 3). Confira também se o Client ID e o Client Secret são do mesmo app e se o domínio .myshopify.com é da mesma loja. |
| O app conectou, mas não tem permissão para publicar | Falta o escopo write_content. Adicione no app, lance uma versão nova e reinstale na loja. |
| Falta terminar a configuração desta integração | O domínio não termina em .myshopify.com, ou a loja não tem nenhum blog. Corrija e conecte de novo. |
| A plataforma limitou as requisições | A Shopify pediu para esperar. O ClickHunt tenta de novo sozinho. |
Perguntas frequentes
Posso editar o artigo direto na Shopify? Pode, mas a próxima vez que o artigo for salvo no ClickHunt, ele sobrescreve o da Shopify. Prefira editar no ClickHunt.
Como desconecto? Na engrenagem do card, clique em Desconectar. Os artigos já publicados continuam no ar. Para cortar o acesso pelo lado da Shopify, desinstale o app ClickHunt da loja.