DoNotify Skill
You can send immediate voice call reminders or schedule future calls through the DoNotify API.
Authentication
All requests require:
- - Header: INLINECODE0
- Header: INLINECODE1
- Base URL:
$DONOTIFY_URL (default: https://donotifys.com)
Endpoints
Check Usage
Check the user's plan, remaining notifications, and phone number status.
CODEBLOCK0
Response:
CODEBLOCK1
Before placing calls, check that phone_number_set is true and remaining is greater than 0. If the phone number is not set, tell the user to configure it in their DoNotify profile.
Call Now
Place an immediate voice call to the user's phone.
CODEBLOCK2
Parameters:
- -
title (required, string, max 255) — What the call is about. This is spoken aloud. - INLINECODE8 (optional, string, max 1000) — Additional details spoken after the title.
Success response:
CODEBLOCK3
Error response (422 if no phone number, 500 if call fails):
CODEBLOCK4
Schedule Reminder
Schedule a voice call for a future time.
CODEBLOCK5
Parameters:
- -
title (required, string, max 255) — Reminder title spoken in the call. - INLINECODE10 (required, ISO 8601 datetime, must be in the future) — When to place the call.
- INLINECODE11 (optional, string, max 1000) — Extra details.
- INLINECODE12 (optional, ISO 8601 datetime) — The actual event time, if different from call time.
Success response (201):
CODEBLOCK6
Behavior Guidelines
- - When the user says "call me now about X" or "remind me right now about X", use the Call Now endpoint.
- When the user says "remind me at [time] about X" or "call me at [time] for X", use the Schedule Reminder endpoint. Convert the user's natural language time to ISO 8601 for
call_at. - When the user asks "how many reminders do I have left" or "check my usage", use the Usage endpoint.
- Always check usage first if you're unsure whether the user has remaining notifications.
- If
phone_number_set is false, tell the user to set their phone number at their DoNotify profile page before placing calls. - Keep titles concise and descriptive — they are read aloud during the call.
DoNotify 技能
您可以通过 DoNotify API 发送即时语音通话提醒或安排未来通话。
身份验证
所有请求都需要：
- - 请求头：Authorization: Bearer $DONOTIFYAPITOKEN
- 请求头：Accept: application/json
- 基础 URL：$DONOTIFY_URL（默认值：https://donotifys.com）
接口端点
检查使用情况
检查用户的套餐、剩余通知次数和电话号码状态。
GET $DONOTIFY_URL/api/usage
响应：
json
{
plan: starter,
notification_limit: 30,
usedthismonth: 5,
remaining: 25,
phonenumberset: true
}
在拨打电话前，请检查 phonenumberset 是否为 true，且 remaining 是否大于 0。如果未设置电话号码，请告知用户在 DoNotify 个人资料中进行配置。
立即呼叫
向用户手机发起即时语音通话。
POST $DONOTIFY_URL/api/call-now
Content-Type: application/json
{
title: 购买日用品,
description: 从Trader Joes购买牛奶、鸡蛋和面包
}
参数：
- - title（必填，字符串，最多255个字符）— 通话的主题。此内容将被语音朗读。
- description（可选，字符串，最多1000个字符）— 在标题之后朗读的附加详情。
成功响应：
json
{
success: true,
reminder_id: 42,
call_uuid: abc-123,
status: completed
}
错误响应（422表示无电话号码，500表示呼叫失败）：
json
{
success: false,
reminder_id: 42,
error: 未配置电话号码。请先更新您的个人资料。,
status: failed
}
安排提醒
安排未来某个时间的语音通话。
POST $DONOTIFY_URL/api/reminders
Content-Type: application/json
{
title: 团队站会,
call_at: 2025-06-15T14:45:00Z,
description: 准备冲刺更新,
event_time: 2025-06-15T15:00:00Z
}
参数：
- - title（必填，字符串，最多255个字符）— 通话中朗读的提醒标题。
- callat（必填，ISO 8601日期时间，必须为未来时间）— 拨打电话的时间。
- description（可选，字符串，最多1000个字符）— 额外详情。
- eventtime（可选，ISO 8601日期时间）— 实际事件时间，如果与通话时间不同。
成功响应（201）：
json
{
success: true,
reminder: {
id: 43,
title: 团队站会,
description: 准备冲刺更新,
call_at: 2025-06-15T14:45:00+00:00,
event_time: 2025-06-15T15:00:00+00:00,
status: pending
}
}
行为指南
- - 当用户说现在打电话给我关于X或立刻提醒我关于X时，使用立即呼叫接口。
- 当用户说在[时间]提醒我关于X或在[时间]打电话给我关于X时，使用安排提醒接口。将用户的自然语言时间转换为ISO 8601格式作为callat参数。
- 当用户问我还剩多少条提醒或检查我的使用情况时，使用使用情况接口。
- 如果不确定用户是否还有剩余通知，请先检查使用情况。
- 如果phonenumber_set为false，请告知用户在DoNotify个人资料页面设置电话号码后再拨打电话。
- 保持标题简洁明了——这些内容将在通话中被朗读出来。
