Guide

Adicionar videoconferência a eventos de calendário

Uma reunião sem link de entrada é uma reunião em que as pessoas aparecem no lugar errado. Adicionar conferência por APIs de provedores significa lidar com conferenceData do Google, onlineMeeting da Microsoft e uma integração separada para cada um. O Nylas CLI anexa um link de vídeo quando você cria um evento com uma flag, e o link segue junto no convite que cada participante recebe. Este guia mostra como adicionar conferência, confirmar que o link foi gravado e usá-lo em um script de agendamento.

Written by Prem Keshari Senior SRE

Verified — CLI 3.1.16 · Gmail, Outlook · last tested June 8, 2026

Referências de comandos usadas neste guia: nylas calendar events create, nylas calendar events show e nylas calendar find-time.

Como adicionar conferência a um evento de calendário?

Você adiciona conferência passando --meeting-link ao criar o evento com nylas calendar events create. O provedor gera um link de vídeo — Google Meet para contas Google, uma reunião online para Microsoft — anexa o link ao evento e o inclui no convite que cada participante recebe. Uma flag substitui os payloads de conferência específicos de cada provedor que você teria que montar manualmente.

Fazer isso diretamente é trabalho específico de provedor. A API do Google exige uma solicitação de criação conferenceData, e o Microsoft Graph define isOnlineMeeting com um onlineMeetingProvider, conforme a documentação de reuniões online do Microsoft Graph. O CLI normaliza ambos por trás da mesma flag, então o comando é idêntico se o organizador estiver no Google ou no Outlook.

# Criar um evento com um link de videoconferência gerado
nylas calendar events create \
  --title "Design review" \
  --start 2026-06-18T16:00:00Z \
  --end 2026-06-18T16:45:00Z \
  --participants alice@example.com,bob@example.com \
  --meeting-link

Como confirmar que o link foi adicionado?

Confirme lendo o evento de volta com nylas calendar events show --id EVENT_ID --json e verificando o bloco de conferência. A URL de entrada fica em conferencing.details.url, então um filtro jq de uma linha imprime exatamente o link em que os participantes vão clicar. Se esse campo estiver preenchido, o link está no evento e no convite.

Isso importa em automações, quando você quer capturar a URL e publicá-la em outro lugar — um lembrete no Slack, um ticket ou um e-mail de confirmação. Extraia a URL do JSON logo após criar o evento e reutilize-a nas etapas seguintes, para que o link na sua mensagem seja o link real gerado pelo calendário, não um placeholder.

# Ler a URL de entrada gerada a partir do evento
nylas calendar events show --id event_abc123 --json \
  | jq -r '.conferencing.details.url'

Como adicionar conferência em um script de agendamento?

Em um script, encadeie disponibilidade e criação: encontre um horário livre com nylas calendar find-time, crie o evento com --meeting-link e depois leia a URL de conferência para incluir na sua própria confirmação. Isso transforma “agendar uma chamada com link” em três comandos, todos neutros em relação ao provedor, para que o mesmo fluxo atenda participantes no Google e no Outlook.

Mantenha a URL de conferência fora de logs e canais públicos — ela é um link de entrada, e qualquer pessoa com ele pode entrar na reunião. Capture-a do JSON, envie somente aos participantes e trate-a como qualquer outra credencial de acesso. Para chamadas recorrentes, crie a série uma vez e reutilize o link em vez de gerar um novo toda semana.

# Encontrar um horário, criar com link e capturar a URL
slot_start=2026-06-19T14:00:00Z
slot_end=2026-06-19T14:30:00Z

id=$(nylas calendar events create \
  --title "Intro call" --start "$slot_start" --end "$slot_end" \
  --participants client@example.com --meeting-link --json | jq -r '.id')

url=$(nylas calendar events show --id "$id" --json | jq -r '.conferencing.details.url')
echo "Join link: $url"

Próximos passos