Versões publicadas e hooks de deploy
Cada publicação do seu site é guardada como uma versão numerada, e a seção Versions das Settings do projeto lista todas elas. Os Deploy hooks, nas mesmas Settings, permitem que outra ferramenta peça ao Briks para publicar seu site novamente. Esta página trata dos dois.
A lista de versões publicadas
A seção lista as últimas 100 versões, da mais nova para a mais antiga. Cada linha mostra:
- Version e o número dela, com uma etiqueta verde Live na versão que os visitantes veem agora.
- Como surgiu: Built, Changed, Checked and repaired ou Published again, e quem pediu.
- A data e a hora da publicação, como 8 out 2026, 14:32.
- Um resumo curto. Em uma alteração, são as palavras que você pediu; em uma criação ou uma nova publicação, é o que a Briks fez.
- Quando uma versão está no ar há uma semana, aparece uma linha dizendo se ela ajudou (veja abaixo).
| Rótulo | O que gerou a versão |
|---|---|
| Built | Uma primeira construção, ou um novo projeto copiado de um modelo ou de outro projeto |
| Changed | Uma alteração que você pediu, código que você salvou no File Explorer, ou uma imagem que você trocou pela biblioteca de mídia |
| Checked and repaired | Uma verificação do site que corrigiu algo que encontrou |
| Publicado de novo | Uma mudança para produção ou de volta para prévia, Apply to the live site, um novo endereço, um domínio entrando no ar ou um deploy hook. O resumo diz qual, como “Publicado de novo com as configurações do site.” |
Para todos os trabalhos do projeto, inclusive os que não publicaram nada, veja Logs.
A mudança ajudou?
Quando uma versão está no ar há 7 dias, a linha dela ganha um texto que compara as visitas antes e depois, para as páginas que a versão alterou, cada uma como média semanal em até 14 dias de cada lado. Ele diz, por exemplo, “Since version 12 (Add a prices section), enquiries from /prices went from 3 to 5 a week, on similar visits.” Quando essas páginas tiveram menos de 25 visitantes por semana, ele diz que houve poucas visitas para concluir algo. Uma alteração feita por um agente é atribuída a esse agente. A linha é calculada a partir da sua própria análise de visitas, sem IA e sem custo. Versões que só foram publicadas de novo e a primeira construção não recebem essa linha. As 12 últimas versões são lidas, e a leitura é definitiva depois de 14 dias.
Restaurar uma versão
Encontre a versão
Onde: Settings, Versions
Toda linha, exceto a que está no ar, tem um botão Restore, se o seu papel permitir editar o projeto.
Restaurar
Onde: Restore version
Pressione Restore. A caixa diz “It goes back on the live site exactly as it was published. The versions after it stay saved, so you can come back.” Pressione Restore version e o número.
Veja a publicação acontecer
Onde: Studio
O Briks leva você ao estúdio enquanto publica. A mensagem diz, por exemplo: “A versão 12 está no ar de novo, exatamente como foi publicada.” A etiqueta Live passa para essa linha.
Restaurar não usa IA. Owners, Admins e Editors podem restaurar; Viewers podem ver a lista. Não é possível durante um teste A/B. Versões, desfazer e refazer trata do mesmo histórico de dentro do estúdio.
O que é um deploy hook
Um deploy hook é um endereço web privado que publica seu site de novo sempre que algo o chama. (Fazer deploy é publicar.) Você entrega o endereço a outra ferramenta, como um serviço de agendamento, e ela o chama quando quiser uma nova publicação.
Uma chamada publica a versão no ar novamente a partir dos próprios arquivos, com as configurações do projeto como estão. Nenhuma IA é executada, nada é cobrado e nada muda além do que você já alterou. As páginas do seu site são montadas na publicação, e não a cada visita, então uma nova publicação reflete:
- os registros publicados mais recentes do banco de dados do site, para quaisquer páginas criadas a partir deles;
- configurações que você mudou desde a última publicação, como o logo, o favicon ou as configurações de busca;
- tudo o que uma página calcula no momento em que é montada.
Ele não faz as alterações que você descreve, não lê dados da ferramenta que o chama e não executa a verificação de lançamento.
Crie um deploy hook
Abrir Deploy hooks
Onde: Settings, Deploy hooks
Abra seu projeto, clique na aba Settings e depois em Deploy hooks, no grupo Developer.
Adicionar um
Onde: Add a deploy hook
Pressione Add deploy hook. Dê a ele o nome de quem vai chamá-lo, como
Nightly scheduler, e pressione Make hook.Copiar o endereço
Onde: Your deploy hook
O Briks mostra o endereço uma única vez. Pressione Copy e cole direto na ferramenta que vai chamá-lo. O Briks não guarda uma cópia legível, então você não poderá vê-lo de novo depois.
Concluir
Onde: Your deploy hook
Pressione Done. O hook entra na lista com a data de criação e “never called”.
Os hooks começam a funcionar depois que o projeto é publicado; até lá, a seção avisa isso. Owners, Admins e Editors podem criar e excluir hooks.
Chamando um hook
A ferramenta deve enviar uma requisição POST para o endereço (o tipo de requisição web que pede que algo aconteça, em vez de apenas ler uma página). A maioria das ferramentas de automação e agendamento tem uma configuração para isso. A janela mostra o formato de uma chamada feita a partir de um terminal: curl -X POST https://app.briks.dev/api/hooks/bdh_…, com o seu endereço completo no lugar do abreviado.
| Quando a chamada chega | O que acontece |
|---|---|
| O site está pronto | Uma publicação começa e aparece no estúdio como qualquer outra. |
| Um build ou uma publicação já está em andamento | A chamada é aceita e unida a ela, então várias chamadas seguidas publicam uma só vez. |
| O hook foi chamado seis vezes na última hora | Recusado: “Este hook foi chamado seis vezes na última hora. Tente novamente mais tarde.” |
| O projeto nunca foi publicado | Recusado: “O projeto ainda não foi publicado.” |
| Um teste A/B está em andamento | Recusado: “Há um teste A/B em andamento neste site. Encerre-o primeiro mantendo uma das versões.” |
| Nem quem criou o hook nem quem criou o projeto tem mais uma conta no Briks | Recusado: “Este hook não tem mais dono. Crie um novo em Deploy hooks do projeto.” |
| O hook foi excluído | O endereço não funciona mais. |
Cada chamada atualiza o horário da “última chamada” na linha do webhook, para você ver que sua ferramenta está funcionando.
Um exemplo prático
O site do Northside Running Club lista as próximas corridas a partir de registros no banco de dados. A organizadora perguntou no estúdio se a página de corridas calcula algo a partir da data quando é publicada. A resposta foi sim: ela escolhe as corridas que ainda vão acontecer naquele momento. Então ela criou um hook chamado
Nightly schedulere configurou o serviço de agendamento que já usava para os e-mails do clube para enviar um POST a ele às 03:00 todas as noites.
Toda manhã, a página de corridas começa a partir daquele dia. A linha do hook mostra quando ele foi chamado pela última vez, e Versions ganha uma linha por noite com o resumo “Published again with the site's settings.”
Lembre-se de que cada publicação adiciona uma versão, então um hook noturno adiciona cerca de trinta linhas por mês em Versions, e a lista mostra as últimas 100. Se não tiver certeza de que uma página depende da data, pergunte antes no estúdio (veja Fazer perguntas); as perguntas são respondidas sem uma compilação.
Deploy hooks e webhooks
| Deploy hook | Webhook | |
|---|---|---|
| Direção | Outra ferramenta chama o Briks | O Briks chama outra ferramenta |
| O que ele faz | Publica seu site de novo | Avisa à ferramenta que algo aconteceu |
| Quando | Sempre que for chamado | Em site.published, form.received ou record.changed |
| Onde | Settings, Deploy hooks | Settings, Webhooks |
Eles funcionam bem juntos. Um webhook em site.published pode avisar outra ferramenta a cada publicação concluída, inclusive uma iniciada por um deploy hook (veja Webhooks).
Excluir um hook
Pressione Delete na linha do hook. A confirmação diz “O endereço deixa de funcionar na hora.” Pressione Delete de novo. As ferramentas que ainda o chamam não conseguem publicar, então remova o endereço delas também.