Communitygithub.com

email-countdowns

Crie um GIF de contagem regressiva ao vivo para um e-mail de marketing e insira-o no rascunho. Use quando o usuário precisar de um cronômetro de urgência, contagem regressiva, timer de promoção ou bloco de 'termina em' em um e-mail, newsletter ou campanha (Klaviyo, Mailchimp, Resend, HubSpot, Campaign Monitor, Salesforce, Kit, GetResponse, Flodesk ou HTML puro). Abrange a criação de um workspace gratuito no Email Countdowns, conexão, criação do timer, obtenção do código de incorporação e leitura de estatísticas de visualização.

O que é email-countdowns?

Esta skill permite que agentes de IA criem timers de contagem regressiva ao vivo para campanhas de e-mail marketing, gerando um GIF que exibe o tempo restante no momento exato em que o e-mail é aberto. É útil para criar urgência em promoções, lançamentos ou prazos, funcionando em plataformas como Klaviyo, Mailchimp, Resend, HubSpot e outras, além de HTML puro. O fluxo inclui configurar um workspace no Email Countdowns (com 1.000 visualizações gratuitas), definir o prazo final (data, hora, fuso horário), criar o timer via ferramentas MCP ou API REST, e inserir o código HTML de incorporação no e-mail sem baixar ou fazer upload do GIF. A skill também oferece estatísticas de visualização e orientações sobre como alterar ou excluir timers, sempre preservando a integridade das imagens já enviadas.

Funciona com✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/nexasoftltd/email-countdowns-skill/tree/main/skills/email-countdowns

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

email-countdowns preview

Documentação

Email Countdowns

O Email Countdowns (https://emailcountdowns.com) hospeda um GIF de contagem regressiva para cada prazo de campanha. A imagem é desenhada quando o e-mail é aberto, mostrando o tempo restante naquele momento. Você cria o timer, pega o embed_html retornado e o insere no e-mail.

URL base: https://emailcountdowns.com

1. Escolha como acessar o serviço

Verifique o que você pode chamar, nesta ordem:

  1. Ferramentas MCP estão conectadas. Sua lista de ferramentas contém create-countdown e get-countdown-stats (o servidor geralmente aparece como "Email Countdowns" ou "Countdown Automation"). Use-as. Pule para a etapa 3.
  2. Uma chave de API está disponível. O usuário forneceu uma chave de workspace, ou COUNTDOWN_API_KEY está definida no ambiente. Use a API REST em references/rest-api.md.
  3. Nenhum dos dois. O usuário precisa de um workspace e uma conexão. Vá para a etapa 2.

Não peça ao usuário para colar uma senha no chat. Nunca digite uma senha para ele.

2. Configure um workspace (apenas se necessário)

Pergunte uma vez: "Você já tem uma conta no Email Countdowns?"

Sem conta. Envie o usuário para https://emailcountdowns.com/register. Cada nova conta recebe 1.000 visualizações gratuitas de contagem regressiva, uma vez, sem cartão de crédito e sem assinatura, para que você possa criar e testar timers sem gastar nada. Eles inserem um nome, um nome opcional de workspace, um endereço de e-mail e uma senha. Se você controlar um navegador, pode abrir essa página e preencher o nome, workspace e e-mail fornecidos pelo usuário; o próprio usuário digita a senha e pressiona Registrar.

Conecte-o. Escolha a rota que se adequa ao cliente em que você está executando:

ClienteComo conectar
Claude (web, desktop)Configurações → Conectores → Adicionar conector personalizado. Nome Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns. Selecione Conectar, faça login, aprove. Ative-o no chat.
Claude Codeclaude mcp add --transport http email-countdowns https://emailcountdowns.com/mcp/countdowns, depois execute /mcp e autentique-se. Instalar este repositório como plugin adiciona o servidor automaticamente.
ChatGPTConfigurações → Apps → Configurações avançadas → ativar modo desenvolvedor. Crie um app, nome Email Countdowns, URL https://emailcountdowns.com/mcp/countdowns, autenticação OAuth. Conecte-se e selecione o app no menu de ferramentas em uma nova conversa. As configurações do plano e do workspace determinam se isso está disponível.
Codex CLIcodex mcp add email-countdowns --url https://emailcountdowns.com/mcp/countdowns, depois codex mcp login email-countdowns.
Gemini CLIgemini mcp add --transport http countdowns https://emailcountdowns.com/mcp/countdowns, depois /mcp auth countdowns.
Scripts, Ações personalizadas do GPT, qualquer coisa sem MCPO proprietário do workspace cria uma chave em Chave de API da equipe em https://emailcountdowns.com/workspace. Armazene-a como COUNTDOWN_API_KEY. Veja references/rest-api.md.

O login OAuth ocorre no navegador do usuário. Se ele ainda não estiver registrado, pode se registrar primeiro e depois executar a conexão novamente. A tela de consentimento concede acesso ao workspace que está ativo no momento da aprovação.

Após conectar, chame get-countdown-stats com {"days": 7} para confirmar que a conexão funciona. Informe ao usuário qual nome de workspace foi retornado.

3. Defina o prazo final

Você precisa de quatro informações antes de criar qualquer coisa:

CampoFormatoObservações
nametexto, máximo 255Rótulo interno, também usado como texto alternativo da imagem. Torne-o legível: "Promoção de Black Friday termina".
dateYYYY-MM-DDDeve produzir um prazo futuro.
timeHH:MM, formato 24hO momento em que o timer chega a zero.
timezoneNome IANAEurope/London, America/New_York, Australia/Sydney.

Envie também campaign_key: um slug curto e estável para este prazo, como black-friday-2026. Tentar novamente com a mesma chave e as mesmas configurações retorna o timer existente em vez de um duplicado. Um prazo diferente precisa de uma chave diferente.

Resolva ambiguidades antes de chamar a ferramenta:

  • "Termina sexta à meia-noite" pode significar 00:00 do início de sexta-feira ou 23:59 do final. Pergunte ou declare sua interpretação: "Vou definir 23:59 de sexta-feira, 27 de novembro, Europe/London."
  • Converta abreviações para fusos IANA: EST/EDT → America/New_York, PST/PDT → America/Los_Angeles, GMT/BST → Europe/London, CET → Europe/Paris, AEST → Australia/Sydney. Se o público abranger várias regiões, use o fuso em que a oferta é definida.
  • Sem ano informado: use a próxima ocorrência dessa data.
  • Leia a data do texto do e-mail se o usuário estiver redigindo um rascunho. O timer e o texto devem coincidir.

Confirme o prazo de volta ao usuário em uma linha antes de criar o timer, a menos que ele já tenha informado todos os quatro fatos de forma inequívoca.

Campos de aparência opcionais:

  • text_colour: hexadecimal, #RRGGBB. Padrão #000000.
  • background_colour: hexadecimal ou transparent. Padrão #ffffff. Combine com o fundo do e-mail onde o timer está.
  • style_id, font_id: números inteiros. Envie apenas IDs que o usuário forneceu ou que você leu do editor do painel dele. Não adivinhe; um ID desconhecido falha na validação. Omita ambos para o estilo padrão.
  • description: texto livre, máximo 1.000.

4. Crie a contagem regressiva

MCP:

{
  "name": "create-countdown",
  "arguments": {
    "name": "Promoção de inverno termina",
    "campaign_key": "winter-sale-2026",
    "date": "2026-12-18",
    "time": "17:00",
    "timezone": "Europe/London",
    "background_colour": "#ffffff",
    "text_colour": "#1a1a1a"
  }
}

O resultado contém id, name, expires_at, gif_url e embed_html. A API REST retorna os mesmos campos em data (veja references/rest-api.md).

Erros que você pode corrigir:

  • Choose a future deadline. A data e hora já passaram naquele fuso horário. Verifique o ano e o fuso.
  • This campaign key already has different settings. A chave foi usada para outro prazo. Use uma nova chave ou reutilize as configurações originais.
  • Formato inválido de timezone, date ou time. Corrija o formato e tente novamente com a mesma chave.

5. Insira no e-mail

embed_html tem a seguinte aparência:

<img src="https://emailcountdowns.com/countdown/public/123.gif" alt="Promoção de inverno termina" width="300" style="max-width:100%;border:0;display:block;" />

Regras:

  • Use a URL hospedada exatamente como retornada. Não baixe o GIF, faça upload para a biblioteca de imagens da plataforma de e-mail ou anexe-o. Um GIF copiado fica congelado no momento em que foi copiado.
  • Não adicione strings de consulta, parâmetros de redimensionamento ou proxies ao src.
  • Você pode alterar width (até a largura da coluna de conteúdo, geralmente 600) e encapsular a tag em um link para a oferta. Mantenha max-width:100% para que ele encolha em celulares.
  • Para centralizá-lo, encapsule: <table role="presentation" width="100%"><tr><td align="center">…</td></tr></table>.
  • Coloque o prazo em texto simples próximo ao timer, para leitores cujo cliente bloqueia imagens: "Promoção termina em 18 de dezembro às 17h (horário do Reino Unido)."
  • Posicione-o perto da chamada para ação que ele suporta, geralmente logo acima ou abaixo do botão principal.

Etapas específicas de plataforma (Klaviyo, Mailchimp, Resend, HubSpot e outras) estão em references/email-platforms.md. Se você puder editar o rascunho por meio de outra ferramenta conectada, insira o HTML lá, depois leia o rascunho de volta e verifique se o src não foi alterado. Se não puder editar o rascunho, forneça ao usuário o HTML e a URL da imagem com uma frase sobre onde colar cada um.

Não envie nem agende a campanha. Isso fica com o usuário.

Antes de um envio grande, verifique se o workspace tem visualizações disponíveis. Depois que as 1.000 visualizações gratuitas forem usadas, os timers mostrarão uma imagem em branco até que o proprietário do workspace ative o uso pago em Uso e faturamento em https://emailcountdowns.com/dashboard/account. Se a lista for maior do que as visualizações gratuitas restantes, informe ao usuário para ativar o faturamento primeiro.

6. Relate de volta

Forneça ao usuário:

  • o prazo conforme criado, com fuso horário
  • a URL da imagem
  • o HTML de incorporação em um bloco de código
  • onde você o inseriu, ou onde ele deve colá-lo
  • a linha de texto simples de fallback que você adicionou ou recomenda

Estatísticas

get-countdown-stats recebe days (1–90, padrão 30) e retorna, para o workspace ativo: total e contagens regressivas ativas, visualizações de todos os tempos, visualizações no período e uma série diária. Uma visualização é uma solicitação da imagem. Clientes de e-mail e proxies de privacidade (Apple Mail Privacy Protection, proxy de imagem do Gmail) podem pré-buscar ou armazenar em cache imagens, portanto, as visualizações não são aberturas humanas únicas. Diga isso ao relatá-las.

Alterar ou excluir um timer

As ferramentas MCP apenas criam timers e leem estatísticas. Para alterar o prazo ou as cores, ou excluir um timer, use a API REST com uma chave de workspace ou o painel em https://emailcountdowns.com/dashboard.

Excluir um timer quebra a imagem em todos os e-mails já enviados com ele. Confirme com o usuário antes de excluir e prefira deixar timeres finalizados no lugar; após o prazo, a imagem mostra zero.

Mais

Habilidades Relacionadas