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"

后续步骤