Uma contagem regressiva de lançamento tem uma única função: dizer aos visitantes quando algo real vai acontecer, e acertar. Quase tudo que dá errado tem a ver com datas. O fuso horário errado, um horário de término digitado como 21h em vez de 9h, um lançamento que atrasa um dia enquanto a barra continua contando para a data antiga. Criar e editar barras pelo Claude torna essas mudanças mais rápidas, e vale saber exatamente como as datas são interpretadas para que rápido não vire descuidado.
Para as regras gerais de honestidade em timers, veja timers de contagem regressiva honestos. Este artigo trata da mecânica a partir de um chat.
Criando a barra
Com o Provedly conectado por uma chave de leitura e escrita, um único prompt resolve:
Crie uma barra de contagem regressiva para o nosso lançamento de inverno terminando em 1º de dezembro às 9h. Mensagem: "A coleção de inverno abre em {timer}".
O assistente chama create_bar. Duas coisas a saber sobre o resultado.
Ela começa pausada. Barras criadas pela API ou pelo MCP nunca aparecem para os visitantes de imediato. O assistente deve dizer isso e repetir o nome, a mensagem e o horário de término que usou. Essa é a sua etapa de revisão.
O horário de término tem fuso horário. Se você informa um horário local, como "1º de dezembro às 9h", ele é armazenado como 2026-12-01 09:00 e lido no fuso horário da própria barra. Se você informa um timestamp ISO 8601 completo, como 2026-12-01T09:00:00-05:00, é usado exatamente esse instante.
Acertando o fuso horário
A forma local é o que a maioria dos lançamentos precisa. "Abre às 9h" no seu marketing significa 9h onde o seu negócio está, e ler o horário de término no fuso da barra corresponde a isso.
Os problemas começam quando quem digita não está no fuso horário da loja. Um fundador em Lisboa configurando um lançamento para uma loja de Nova York, ou uma agência num país trabalhando para um cliente em outro. Nesses casos, seja explícito:
Crie a barra terminando em 1º de dezembro às 9h, horário de Nova York.
ou informe você mesmo o timestamp. Depois peça ao assistente que mostre o horário de término que armazenou. Se a resposta não for o que você quis dizer, corrija antes de ativar a barra, que é exatamente para isso que serve o início pausado.
Depois que o momento final é armazenado, ele é um único instante fixo para todos. Um visitante em outro fuso vê o mesmo prazo, contado a partir de onde ele estiver, então você só precisa acertar uma vez.
Ativando
Quando os detalhes estiverem certos:
Está bom, pode ativar.
O assistente chama set_bar_status e a barra fica ativa. A ativação conta para o limite de barras do seu plano, igual ao painel. Se você estiver no limite, o pedido é recusado com o motivo, e você pode pausar outra barra antes.
Se você tem o snippet de uma linha para o site instalado, que está sendo liberado agora, a barra aparece no site sem nenhuma mudança de código. Sem ele, confirme que a barra está instalada no seu site do mesmo jeito que as suas outras barras. O plugin para WordPress já carrega as barras em todas as páginas para você.
Quando o lançamento muda de data
Lançamentos atrasam. Quando o seu atrasar, mude a data de término uma vez, para o novo horário real:
O lançamento mudou. Altere a data de término do lançamento de inverno para 2 de dezembro às 9h.
Isso chama update_bar. Atualize a mensagem ao mesmo tempo se ela mencionar uma data. O que você não deve fazer é ficar empurrando o prazo para frente toda vez que ele se aproxima. Uma contagem regressiva que reinicia é o padrão clássico de urgência falsa, e visitantes que voltam e veem o timer ainda correndo percebem. Urgência honesta com um assistente de IA mostra como manter pedidos como esse honestos.
Quando termina
No zero, a contagem regressiva cumpriu seu papel. Pause a barra ou substitua-a por algo verdadeiro para a próxima fase:
Pause a barra do lançamento de inverno e crie uma barra de anúncio dizendo "A coleção de inverno está no ar. Devolução grátis até 15 de janeiro."
A nova barra de anúncio é criada pausada, como toda barra feita pela API, então você a aprova antes que apareça. Depois, peça a lista de barras ativas para ter certeza de que a contagem antiga não continua rodando.
Um padrão para lançamentos recorrentes
Se você lança num ritmo, digamos um drop mensal, mantenha a barra em vez de criar uma nova a cada vez. Depois de cada lançamento, pause-a. Antes do próximo:
Atualize a barra do drop mensal: data de término 5 de janeiro às 10h, mensagem "O drop de janeiro abre em {timer}". Deixe-a pausada.
Depois revise e ative. O histórico da barra fica num só lugar, e as estatísticas de cada janela de lançamento são fáceis de puxar com get_stats.
Perguntas frequentes
Que formato devo usar para a data de término?
Ou um horário local como "2026-12-01 09:00", lido no fuso horário da barra, ou um timestamp ISO 8601 completo. Frases naturais como "1º de dezembro às 9h" são convertidas pelo assistente em um desses formatos; peça que ele mostre o valor armazenado.
A barra pode se ativar sozinha num horário definido?
Barras criadas por chat começam pausadas e vão ao ar quando você as ativa. O horário de término é agendado; o início é decisão sua.
O que acontece quando a contagem regressiva chega a zero?
A contagem termina nesse momento para todos os visitantes. Pause a barra ou substitua-a, para que a página não continue mostrando uma oferta que já acabou.
Cadastre-se grátis e teste uma contagem regressiva de lançamento no plano Free.