Documentation menu

Bloco Link de reunião

Detalhes de acesso para um evento online ou híbrido: um rótulo de provedor, uma URL de acesso, um horário de início, e quantos minutos antes do início o link de acesso deve passar a se apresentar como ativo. É o bloco por trás do momento "clique aqui para entrar" de um webinar ou convite de reunião remota, construído para se manter preciso independentemente de o destinatário abrir o e-mail uma semana antes ou trinta segundos antes de a chamada começar.

Como funciona

O campo de provedor (Zoom, Google Meet, Microsoft Teams, ou Personalizado) é apenas um rótulo — não há OAuth nem conexão de conta com nenhum deles, apenas uma URL simples que você mesmo cola. Ele existe para escolher o texto do botão de acesso ("Entrar pelo Zoom" vs. um genérico "Entrar na reunião" para Personalizado), nada mais.

O HTML enviado por e-mail sempre renderiza o botão de acesso como um link real e clicável, a mesma convenção de "estático no momento do envio" usada pelos blocos de contagem regressiva e produto. Um e-mail não pode ser buscado novamente conforme o horário de início da reunião se aproxima, então não há como bloqueá-lo ali.

Ao lado do botão, uma linha de status e um selo acompanham a contagem regressiva. Enquanto startsAt está no futuro, ele exibe "Começa em Xd Xh Xm" (ou "Xh Xm" quando falta menos de um dia), junto de um pequeno GIF renderizado no servidor construído com a mesma técnica de imagem de contagem regressiva usada pelo bloco de Contagem regressiva. Essa imagem continua contando corretamente em cada abertura, mesmo sendo uma imagem estática regenerada a cada requisição, e não algo animado no lado do cliente. Assim que o horário de início passa, o selo muda para "Ao vivo agora", sem mais contagem.

A visualização ao vivo hospedada é o único lugar onde este bloco realmente bloqueia o controle de acesso, porque, diferente de um e-mail enviado, a visualização ao vivo é buscada novamente a cada visita. Ali, o botão de acesso só aparece quando o horário de renderização está dentro de opensMinutesBefore minutos de startsAt. Antes que essa janela se abra, o destinatário vê um chip cinza inerte com o texto "Abre N minutos antes do início" (ou "Ainda não aberto" se opensMinutesBefore for 0), em vez de um link funcional. Isso é calculado de forma síncrona a partir das próprias propriedades do bloco em relação ao relógio atual — sem leitura no Firestore, sem estado de resposta armazenado — então é barato em toda renderização da visualização ao vivo. Um bloco sem startsAt definido está sempre aberto, tanto no e-mail quanto na visualização ao vivo, já que não há nada contra o que bloquear.

A linha opcional de discagem, se preenchida, é renderizada como texto simples ao lado do botão de acesso em todos os níveis — ela não é em si um link, apenas um número de telefone para quem for entrar somente por voz.

Campos configuráveis:

  • Provedor — Zoom, Google Meet, Microsoft Teams, ou Personalizado (apenas rótulo).
  • URL de acesso — para onde o botão leva.
  • Começa em — o horário de início da reunião; também alimenta o selo "Começa em" e o bloqueio da visualização ao vivo.
  • Discagem (opcional) — um número de telefone renderizado como texto simples.
  • Link de acesso abre quantos minutos antes do início — a janela de bloqueio da visualização ao vivo (padrão 15; 0 significa que o link só fica inerte exatamente até o instante de início).
  • Cor de fundo, preenchimento (padding), borda e raio da borda no cartão.
  • Cor/tamanho do rótulo de status, e substituições de cor/fundo do botão de acesso.

Não há nada a responder em um bloco Link de reunião — é um conteúdo que se atualiza ao vivo, não uma pergunta — então ele nunca aparece no painel de respostas nem na exportação de CSV. O próprio clique de acesso ainda é rastreado no mapa de calor de cliques do bloco, como qualquer outro link, através do slot genérico de rastreamento de clique que todo bloco simples com link compartilha.

Exemplos

Subject

Your seat is booked — join link inside

Um convite de webinar combina um bloco Link de reunião com uma Contagem regressiva mais acima no e-mail — a contagem regressiva cria urgência nos dias anteriores, e o selo do link de reunião assume com uma leitura precisa de "Começa em" conforme o momento se aproxima. Para um evento híbrido, coloque tanto um Link de reunião quanto um bloco Local no mesmo e-mail, para que participantes remotos e presenciais recebam cada um o controle que se aplica a eles. O propósito de projeto "Evento" já começa exatamente com essa combinação — veja Eventos e webinars. Definir opensMinutesBefore para algo como 10 ou 15 evita que quem clica cedo entre em uma chamada praticamente vazia e não encontre nada acontecendo ainda.

Como é o fallback estático

<div style="margin:12px 0;background-color:transparent">
  <p style="margin:0 0 6px;font-size:13px;font-weight:600;color:#111827">Starts in 2h 14m</p>
  <img src="https://mailinapp.com/api/countdown?t=1753401600000&c=111827&s=9f2a..." width="220" height="40" alt="Starts in 2h 14m"
       style="display:block;max-width:100%;height:auto;margin-bottom:8px" />
  <a href="https://zoom.us/j/123456789"
     style="display:inline-block;padding:10px 20px;background-color:#4f46e5;color:#ffffff;
            border-radius:6px;text-decoration:none;font-size:14px;font-weight:600">
    Join on Zoom
  </a>
  <p style="margin:8px 0 0;font-size:13px;color:#4b5563">Dial in: +1 415 555 0100</p>
</div>

Este é o nível enviado por e-mail: um selo de contagem regressiva ao vivo, um link de acesso sempre clicável direto para a URL da reunião, e a linha de discagem em texto simples — sem bloqueio, já que o e-mail é estático no momento do envio.

Veja também