--- title: "Versões publicadas e hooks de deploy | Briks" url: https://briks.dev/pt-br/docs/publish-history description: "Veja cada versão publicada do seu site, restaure uma e crie deploy hooks: endereços privados que publicam seu site de novo quando outra ferramenta os chama." last_updated: 2026-10-08 --- # 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. 7 min de leitura Conferido com o estúdio em 8 de outubro de 2026 ## A lista de versões publicadas Onde 1. Projects 2. Your project 3. Settings 4. Versions 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](https://briks.dev/pt-br/docs/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](https://briks.dev/pt-br/docs/analytics), 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 1. 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. 2. 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. 3. 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](https://briks.dev/pt-br/docs/versions) 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. Quando você não precisa de um As alterações que você pede no estúdio são publicadas sozinhas. As edições na aba **Database** também: o site é publicado de novo logo após uma edição, e depois no máximo uma vez a cada cinco minutos, não importa quantas edições você faça. Um deploy hook serve para publicações que começam fora do estúdio. ## Crie um deploy hook 1. Abrir Deploy hooks Onde: Settings, Deploy hooks Abra seu projeto, clique na aba **Settings** e depois em **Deploy hooks**, no grupo **Developer**. 2. 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**. 3. 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. 4. 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. Mantenha privado Como o aviso da caixa de diálogo diz, qualquer pessoa com o endereço pode publicar seu projeto de novo. Guarde-o onde só as suas ferramentas possam lê-lo. Se vazar, exclua o hook e crie um novo. ## 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. Use um agendador fora do Briks As **Scheduled tasks** do próprio projeto não podem chamar um deploy hook, porque recusam endereços em briks.dev. Para publicar em um horário, use um serviço de agendamento que você já tenha. ## Um exemplo prático Exemplo Uma publicação noturna para um grupo de corrida > 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 scheduler` e 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](https://briks.dev/pt-br/docs/asking-questions)); 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](https://briks.dev/pt-br/docs/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. ## Leia a seguir - [Trabalhando em um projeto **Versões, desfazer e refazer** Cada build e alteração é salva como versão do seu site. Desfaça, refaça ou recoloque no ar qualquer versão anterior, exatamente como era, sem reter créditos.](https://briks.dev/pt-br/docs/versions) - [Dados e automação **Webhooks** Mande mensagem assinada a outra ferramenta ao publicar o site, enviar um formulário ou mudar registro. Payloads, assinaturas, tentativas, entregas explicados.](https://briks.dev/pt-br/docs/webhooks) - [Dados e automação **Tarefas agendadas** Execute tarefas agendadas no seu site: resumo matinal, limpeza semanal. Escreva o horário, leia cada execução, corrija falhas e veja os limites do plano.](https://briks.dev/pt-br/docs/crons) - [Dados e automação **Logs** Leia o log de build e as requisições do último dia do seu site, filtre por nível ou status e ache formulário com falha, tarefa com falha ou página lenta.](https://briks.dev/pt-br/docs/logs) Ainda travado? Escreva para [hello@briks.dev](mailto:hello@briks.dev) com o nome do seu projeto e o que você esperava ver. Uma captura de tela ajuda.