Guide

캘린더 이벤트에 화상 회의 추가하기

참가 링크가 없는 회의는 사람들이 엉뚱한 곳에 나타나는 회의입니다. 제공자 API로 회의를 추가하려면 Google의 conferenceData, Microsoft의 onlineMeeting, 그리고 제공자별 별도 처리가 필요합니다. Nylas CLI는 이벤트를 만들 때 하나의 플래그로 비디오 링크를 붙이고, 그 링크는 모든 참석자가 받는 초대에 함께 포함됩니다. 이 가이드는 회의를 추가하고, 링크가 들어갔는지 확인하고, 예약 스크립트에서 사용하는 방법을 보여줍니다.

Written by Prem Keshari Senior SRE

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

이 가이드에서 사용하는 명령 참조: nylas calendar events create, nylas calendar events show, nylas calendar find-time.

캘린더 이벤트에 회의를 어떻게 추가하나요?

nylas calendar events create로 이벤트를 만들 때 --meeting-link를 전달하면 회의를 추가할 수 있습니다. 제공자가 비디오 링크를 생성합니다 — Google 계정은 Google Meet, Microsoft는 온라인 회의 — 그리고 이벤트에 첨부해 각 참석자가 받는 초대에 포함합니다. 하나의 플래그가 직접 만들어야 했던 제공자별 회의 payload를 대체합니다.

이를 직접 구현하면 제공자별 작업이 됩니다. Google API는 conferenceData 생성 요청이 필요하고, Microsoft Graph는 Microsoft Graph 온라인 회의 문서에 따라 onlineMeetingProvider와 함께 isOnlineMeeting을 설정합니다. CLI는 둘 다 하나의 플래그 뒤에서 정규화하므로, 주최자가 Google을 쓰든 Outlook을 쓰든 명령은 동일합니다.

# 생성된 화상 회의 링크가 포함된 이벤트 만들기
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

링크가 추가되었는지 어떻게 확인하나요?

nylas calendar events show --id EVENT_ID --json으로 이벤트를 다시 읽고 회의 블록을 확인합니다. 참가 URL은 conferencing.details.url에 있으므로, 한 줄짜리 jq 필터로 참석자가 실제로 클릭할 링크를 정확히 출력할 수 있습니다. 이 필드가 채워져 있으면 링크가 이벤트와 초대에 들어간 것입니다.

자동화에서는 이 URL을 캡처해 Slack 알림, 티켓, 확인 이메일 같은 다른 곳에 게시하고 싶을 때가 많으므로 중요합니다. 이벤트를 만든 직후 JSON에서 URL을 가져와 이후 단계에서 재사용하면, 메시지의 링크가 자리표시자가 아니라 캘린더가 실제로 생성한 링크가 됩니다.

# 이벤트에서 생성된 참가 URL 읽기
nylas calendar events show --id event_abc123 --json \
  | jq -r '.conferencing.details.url'

예약 스크립트에서 회의를 어떻게 추가하나요?

스크립트에서는 가용 시간 조회와 생성을 연결합니다. nylas calendar find-time으로 빈 시간을 찾고, --meeting-link로 이벤트를 만든 다음, 회의 URL을 다시 읽어 자체 확인 메시지에 포함하세요. 그러면 “링크가 있는 통화 예약”이 세 개의 명령으로 바뀌며, 모두 제공자 중립적이어서 같은 흐름으로 Google과 Outlook 참석자를 처리할 수 있습니다.

회의 URL은 로그나 공개 채널에 남기지 마세요 — 참가 링크이므로 링크가 있는 사람은 누구나 회의에 들어갈 수 있습니다. JSON에서 캡처하고 참석자에게만 보내며, 다른 접근 자격 증명처럼 다루세요. 반복 통화의 경우 매주 새 링크를 만들지 말고 시리즈를 한 번 만든 뒤 링크를 재사용하세요.

# 시간 찾기, 링크 포함 생성, 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"

다음 단계