O que você vai montar
Com o Webflow conectado, os artigos gerados no ClickHunt entram direto numa coleção do CMS do seu site Webflow, com título, endereço (slug), corpo, resumo e imagem de capa. A conexão usa um token de API do site, gerado por você no próprio Webflow.
Disponível a partir do plano Pro. Só o dono ou um administrador do projeto consegue configurar.
Antes de começar
- Uma coleção de CMS para os posts. O Webflow não tem um "blog" pronto: os posts moram numa coleção que você cria no Designer (por exemplo, "Blog Posts"). Ela precisa ter pelo menos um campo do tipo Rich text para o corpo do artigo.
- Um plano de site com CMS no Webflow e o site publicado pelo menos uma vez.
- Campos obrigatórios que o ClickHunt sabe preencher. O ClickHunt preenche nome, slug, campos de texto, rich text e imagem. Se a coleção tiver um campo obrigatório de outro tipo (referência, opção, data, número, link), deixe esse campo opcional no Webflow ou a conexão vai pedir para você fazer isso.
Passo 1: gere o token de API do site
- No Webflow, abra o painel do site e entre em Site settings.
- Vá em Apps & integrations e role até API access.
- Clique em Generate API token.
- Dê um nome, por exemplo
ClickHunt. - Escolha as permissões:
- Sites: leitura (Read-only).
- CMS: leitura e escrita (Read and write).
- Clique em Generate token e copie o token. Ele aparece uma única vez.
Cada site aceita até 5 tokens. O token expira se ficar 365 dias sem uso.
Passo 2: cole no ClickHunt
- No projeto, abra Configurações › Integrações, seção Hospedagem.
- No card Webflow, clique no ícone de engrenagem (Configurar).
- Em Token da API do site, cole o token do passo 1. Ele fica guardado cifrado e nunca aparece de volta na tela.
- Clique em Conectar. O status fica Verificando por alguns segundos.
Passo 3: escolha a coleção e os campos
Depois da verificação, a engrenagem do card mostra a configuração da coleção. Cada escolha é salva na hora.
- Em Coleção que recebe os artigos, escolha a coleção dos posts.
- Em Para onde vai cada parte do artigo, confira os campos. O ClickHunt já sugere os que reconhece pelo nome, mas confirme cada um:
- Corpo do artigo (obrigatório): um campo Rich text.
- Resumo (opcional): um campo de texto ou rich text.
- Imagem de capa (opcional): um campo de imagem.
- O título do artigo vai sempre para o campo Name e o endereço para o campo Slug, que toda coleção do Webflow tem.
- Com a coleção e o corpo escolhidos, o card sai de Necessita configurar e passa para Pronto para ativar.
- Para os próximos artigos irem para o Webflow, clique no botão principal Conectar do card e confirme. O card passa para Conectado.
O que vai para o Webflow
- Título e slug. Nos campos Name e Slug da coleção.
- Corpo. O texto completo, com títulos, listas, tabelas, imagens e FAQ, no campo de rich text que você escolheu.
- Resumo. No campo escolhido, se você mapear um.
- Capa. O Webflow baixa a imagem e hospeda na própria biblioteca de mídia.
- Publicação. O item entra na coleção já publicado. Quando o artigo é salvo de novo no ClickHunt, o mesmo item é atualizado. Se o item for apagado no Webflow, o ClickHunt cria outro.
O que não vai: categorias, tags e autor. No Webflow esses dados costumam ser referências a outras coleções, e o ClickHunt não preenche esse tipo de campo.
Sobre o link do post: o Webflow não informa o endereço público do item, porque ele depende da página de modelo da coleção no seu site. Por isso o ClickHunt não mostra o link do artigo publicado no Webflow.
Mensagens de erro
| Situação | O que fazer |
|---|---|
| O token foi recusado | O token foi apagado ou expirou. Gere um novo (passo 1) e cole de novo. |
| O token conecta, mas não tem permissão | Gere um token com Sites: Read-only e CMS: Read and write. |
| Esta coleção exige campos que não sabemos preencher | A mensagem lista os campos. Deixe-os opcionais nas configurações da coleção no Webflow ou escolha outra coleção. |
| Falta terminar a configuração desta integração | Falta escolher a coleção ou o campo do corpo. Abra a engrenagem do card e complete o passo 3. |
| Publique este item uma vez na própria plataforma | O item existe no Webflow, mas nunca foi publicado lá. Publique o item (ou o site) uma vez no Webflow; depois as atualizações seguem sozinhas. |
| A plataforma limitou as requisições | O Webflow tem limite de chamadas por minuto. Não precisa fazer nada: o ClickHunt tenta de novo sozinho. |
Perguntas frequentes
Posso editar o item direto no Webflow? Pode, mas a próxima vez que o artigo for salvo no ClickHunt, ele sobrescreve o item. Prefira editar no ClickHunt.
Criei um campo novo na coleção. Ele aparece? Abra a engrenagem do card de novo: a lista de campos é lida na hora.
Como desconecto? Na engrenagem do card, clique em Desconectar. Os itens já publicados continuam no site. Para cortar o acesso pelo lado do Webflow, apague o token em Site settings › Apps & integrations › API access.