Skip to content

Links de adicionar ao calendário

Ao promover um evento, promoção ou compromisso, você pode ajudar os usuários a salvar facilmente o evento no calendário adicionando um link “adicionar ao calendário” nos seus e-mails.

Crie o rascunho do seu e-mail e escolha onde as duas opções de calendário aparecerão: um link para o Google Calendar e outro para outros calendários (como iCal ou Outlook). Use textos de link como “Adicionar ao Google Calendar” e “Adicionar ao iCal ou Outlook”.

A forma de anexar as URLs depende do editor de e-mail que você usa:

  • Editor de arrastar e soltar: Em um bloco Paragraph, selecione as palavras que deseja vincular, abra o controle Link na barra de ferramentas e cole a URL do formato de URL. Ou use um bloco Button, defina Link type como Open web page e cole a URL em URL.
  • Editor de HTML: Use os controles de link de rich text para texto vinculado, ou adicione tags <a href="..."> no seu HTML para cada URL de calendário.

Formato da URL

Adicione a seguinte URL aos seus links, substituindo os espaços reservados. A única diferença entre essas duas URLs é que o Google Calendar precisa de um parâmetro adicional: &format=gcal.

1

https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION&format=gcal

1

https://ics.agical.io/?subject=EVENT_SUBJECT&location=EVENT_LOCATION&dtstart=START_TIME&dtend=END_TIME&description=EVENT_DESCRIPTION

Substitua os seguintes valores:

  • EVENT_SUBJECT: Título do evento
  • EVENT_LOCATION: Local do evento
  • START_TIME: Horário de início do evento no formato ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) em UTC
  • END_TIME: Horário de término do evento no formato ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) em UTC
  • EVENT_DESCRIPTION: Descrição do evento

Substitua quaisquer espaços pelo código de escape HTML %20. Por exemplo, um assunto “Meet Braze” ficaria como “Meet%20Braze”.

Veja um exemplo de URL “Adicionar ao Google Calendar”:

1

https://ics.agical.io/?subject=Meet%20Braze&location=114%20Sansome%20Street&dtstart=2021-06-24T15:00:00Z&dtend=2021-06-24T16:00:00Z&description=Braze%20Party&format=gcal

Parâmetros adicionais

Os parâmetros a seguir são opcionais e podem ser usados para definir aspectos adicionais de um evento.

  • Nome do organizador: &organizer=name
  • Anexar URL relacionada ao evento: &attach=http://www.example.com/
  • Duração: duration=30M, como alternativa ao horário de término do evento (dtend), especifique uma duração como 1H ou 30M
  • Horário do lembrete, em minutos: &reminder=15
  • Evento de dia inteiro: &allday=1
  • UID: parâmetro opcional para definir manualmente o identificador único do evento, permitindo que alguns apps de calendário atualizem o evento ao longo do tempo. A string @ics.agical.io é automaticamente adicionada ao valor.

Você também pode adicionar parâmetros adicionais para eventos recorrentes:

  • Eventos semanais: &recur=weekly
  • Eventos mensais: &recur=monthly
  • Fim da recorrência: &recuruntil=END_DATE, em que END_DATE é a data e o horário em que a recorrência termina no formato ISO 8601 (YYYY-MM-DDTHH:MM:SSZ) em UTC

Quando um usuário clica no link, os calendários transformam automaticamente os timestamps UTC nas URLs para refletir o fuso horário do usuário definido no calendário.

Por exemplo, se você abrir o link de exemplo “Adicionar ao Google Agenda” e seu calendário estiver configurado para CST, o horário do evento será preenchido automaticamente de acordo com o que 15h UTC representa em CST (10h).

Google Agenda

Ao clicar, o Google Agenda abre em uma nova guia ou janela com os detalhes do evento preenchidos no convite e prontos para o usuário salvar. Isso acontece tanto no celular quanto no desktop.

Caixa de diálogo do Google Agenda para adicionar um evento com os detalhes do evento preenchidos e prontos para salvar.

iCal ou Outlook

Ao clicar no desktop, um arquivo ICS é baixado. O usuário precisa então abrir o arquivo ICS, que abre o iCal ou o Outlook e solicita que o usuário adicione o evento ao calendário.

Calendário iCal com uma caixa de diálogo para adicionar um novo evento, que solicita ao usuário selecionar um calendário e confirmar.

Calendário iCal com o evento adicionado.

No celular, o comportamento depende do dispositivo e do app de e-mail.

Em alguns outros apps de e-mail ou navegadores no celular, pressionar e segurar o link pode exibir uma opção para adicionar o evento a um calendário.

Pop-up do iOS quando você pressiona e segura um link de calendário, que inclui um botão "Adicionar ao Calendário".

Para saber mais, consulte:
New Stuff!