WhenToMeetWhenToMeet

通过 URL 创建事件（Event Creation URLs）

WhenToMeet 支持通过 URL 参数预填创建事件的表单。这对于使用预设配置快速创建事件链接非常有用。

基本用法

你可以创建带有参数的 URL，自动填充事件创建表单，常见用途包括：

  • 快速生成重复事件的创建链接
  • 与团队共享事件模板
  • 与日历应用集成
  • 预设具体时间的事件邀请

URL 参数

基础事件信息

参数类型描述示例
titlestring事件标题title=Team%20Meeting
descriptionstring事件描述description=Weekly%20sync%20meeting

时间段（Time Slots）

参数类型描述示例
slotsstring[]以 ISO 8601 格式表示的时间段slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
slotLengthnumber默认时间段时长（分钟，15-1440 之间）slotLength=60

示例

简单事件

/events/new?title=Team%20Meeting&description=Weekly%20sync

带有时间段的事件

/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slotLength=60

完整事件模板

/events/new?title=Project%20Kickoff&description=Initial%20project%20meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:30:00Z&slots=2024-01-15T14:00:00Z,2024-01-15T15:30:00Z&slotLength=90

时间段格式

时间段必须以 ISO 8601 格式提供，要求如下：

  • 格式：YYYY-MM-DDTHH:mm:ssZ
  • 持续时间：至少 30 分钟
  • 未来时间：所有时间段必须是未来时间
  • 不可重叠：时间段之间不可重叠

合法示例

2024-01-15T09:00:00Z,2024-01-15T10:00:00Z
2024-01-16T14:30:00Z,2024-01-16T16:00:00Z

非法示例

2024-01-15T09:00:00Z,2024-01-15T09:15:00Z  # 太短（15 分钟）
2024-01-15T10:00:00Z,2024-01-15T09:00:00Z  # 结束时间早于开始时间
2023-01-15T09:00:00Z,2023-01-15T10:00:00Z  # 过去的时间

多个时间段

要指定多个时间段，可重复使用 slots 参数：

/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z&slots=2024-01-16T14:00:00Z,2024-01-16T15:00:00Z&slots=2024-01-17T16:00:00Z,2024-01-17T17:00:00Z

URL 编码

手动创建 URL 时，请记得对特殊字符进行 URL 编码：

字符编码
空格%20
逗号%2C
冒号%3A
斜杠%2F

示例

原始：Team Meeting, Weekly Sync
编码：Team%20Meeting%2C%20Weekly%20Sync

集成示例

日历应用

许多日历应用支持通过 URL 参数创建事件。你可以将 WhenToMeet 的 URL 作为事件 URL：

Calendar Event URL: https://whentomeet.io/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z

邮件模板

在邮件模板中包含 WhenToMeet URL 以快速创建事件：

<a
  href="https://whentomeet.io/events/new?title=Team%20Meeting&slots=2024-01-15T09:00:00Z,2024-01-15T10:00:00Z"
>
  创建团队会议
</a>

Slack/Teams 集成

在团队沟通工具中使用 WhenToMeet URL：

https://whentomeet.io/events/new?title=Daily%20Standup&slots=2024-01-15T09:00:00Z,2024-01-15T09:15:00Z&slotLength=15

最佳实践

  1. 保持链接简短：仅包含必要参数
  2. 使用有意义的标题：让事件目的更清晰
  3. 提供多个时间段：给参与者更多选择
  4. 设置合适的时长：结合会议类型
  5. 测试你的 URL：确保其按预期工作

限制

  • 时间段最大时长：24 小时
  • 时间段最小时长：30 分钟
  • 每个事件的时间段数量：不限（但需考虑可用性与体验）
  • 所有时间段必须是未来时间
  • 时间段之间不可重叠

故障排查

常见问题

  1. 日期格式无效：确保使用 ISO 8601 格式
  2. 过去时间：所有时间段必须是未来时间
  3. 时间段重叠：时间段之间不可重叠
  4. 时长过短：时间段至少 30 分钟
  5. URL 编码：必须正确编码特殊字符

错误信息

  • "Invalid slot format"：检查日期格式
  • "Slot duration must be at least 30 minutes"：增加时长
  • "Time slots cannot overlap"：调整时间
  • "All time slots must be in the future"：使用未来时间

Was this page helpful?