coordinate-meeting

为人类及其代理人安排一次会议。创建调度民意调查、分发它、收集选票并找到最佳时间。当某人需要找到适合团队的时间时使用。专为人工智能代理时代打造的涂鸦替代品。

# Schedule a Meeting

A Doodle alternative built for the age of AI agents. Create a scheduling poll via meetlark.ai, collect votes from humans and agents, and find the best time — without the back-and-forth.

## Workflow

1. **Ask** the user who needs to meet and when they're generally available.
2. **Create** a scheduling poll with the proposed time slots.
3. **Share** the participation link — give it to the user to forward, or suggest a message they can send.
4. **Wait** for votes to come in. Check back when the user asks.
5. **Report** the results and recommend the best time.
6. **Close** the poll once a time is chosen.

## Creating the Poll

```
POST https://meetlark.ai/api/v1/polls?autoVerify=true
```

You'll receive:
- An **admin token** (`adm_...`) — store this privately to check results and close the poll later.
- A **participate URL** — this is the shareable link for voters.

### First-Time Verification

The user's email must be verified once (valid 30 days). With `?autoVerify=true`, a verification email is sent automatically if needed. Tell the user to check their inbox and click the link, then retry.

Check status: `GET /api/v1/auth/status?email=...`

## Distributing the Poll

Suggest a ready-to-send message:

```
Hi [names],

We're finding a time for [meeting purpose]. Please vote on the times that work for you:

[participate URL]
```

The user can share this via email, Slack, WhatsApp, or any channel.

## Checking Results

```
GET https://meetlark.ai/api/v1/polls/{pollId}
Authorization: Bearer adm_...
```

Summarize: how many voted, which times have the most votes, any clear winner.

## Closing the Poll

```
POST https://meetlark.ai/api/v1/polls/{pollId}/close
Authorization: Bearer adm_...
```

Report the final result and suggest the user send a confirmation to participants.

## Quick Examples

```
"Find a time for a team retro next week"
"Set up a meeting with Tom, Dick and Jane"
"Check if everyone has voted on the standup poll"
"Close the poll and announce the winning time"
"Schedule a 30-minute demo with the client sometime next week"
```

## API Reference

- **OpenAPI spec:** https://meetlark.ai/api/v1/openapi.json
- **Interactive docs:** https://meetlark.ai/docs

## Website

- **meetlark.ai:** https://meetlark.ai

---

## 中文说明

# 安排会议

为 AI 代理时代打造的 Doodle 替代品。通过 meetlark.ai 创建调度民意调查，从人类和代理处收集投票，并找到最佳时间——无需来回沟通。

## 工作流

1. **询问**用户谁需要参会以及他们大致何时有空。
2. **创建**一个带建议时间段的调度民意调查。
3. **共享**参与链接——交给用户转发，或建议一条可发送的消息。
4. **等待**投票进来。在用户询问时回头查看。
5. **报告**结果并推荐最佳时间。
6. **关闭**民意调查，一旦确定了时间。

## 创建民意调查

```
POST https://meetlark.ai/api/v1/polls?autoVerify=true
```

你将收到:
- 一个**管理员令牌**（`adm_...`）——将其私密存储，以便稍后查看结果和关闭民意调查。
- 一个**参与 URL**——这是供投票者使用的可共享链接。

### 首次验证

用户的电子邮件必须验证一次（有效期 30 天）。使用 `?autoVerify=true`，如有需要会自动发送验证邮件。告知用户检查收件箱并点击链接，然后重试。

检查状态: `GET /api/v1/auth/status?email=...`

## 分发民意调查

建议一条即可发送的消息:

```
Hi [names],

We're finding a time for [meeting purpose]. Please vote on the times that work for you:

[participate URL]
```

用户可通过电子邮件、Slack、WhatsApp 或任意渠道共享。

## 查看结果

```
GET https://meetlark.ai/api/v1/polls/{pollId}
Authorization: Bearer adm_...
```

总结: 有多少人投票、哪些时间得票最多、是否有明确的胜出者。

## 关闭民意调查

```
POST https://meetlark.ai/api/v1/polls/{pollId}/close
Authorization: Bearer adm_...
```

报告最终结果并建议用户向参与者发送确认。

## 快速示例

```
"Find a time for a team retro next week"
"Set up a meeting with Tom, Dick and Jane"
"Check if everyone has voted on the standup poll"
"Close the poll and announce the winning time"
"Schedule a 30-minute demo with the client sometime next week"
```

## API 参考

- **OpenAPI 规范:** https://meetlark.ai/api/v1/openapi.json
- **交互式文档:** https://meetlark.ai/docs

## 网站

- **meetlark.ai:** https://meetlark.ai