跳转到主要内容
本页面是示例应用:完整的 OneSignal 集成的一部分,该指南从头到尾跟随一个真实应用。这个应用是 Clean Beans,一款面向合租家庭的打扫值日表应用,使用 Expo(React Native)和 Supabase 后端构建。 Clean Beans 的大多数通知都由后端发送,因为它们取决于计划任务或其他人的操作。它们都调用同一个端点 Create message,并通过 External ID 定向用户。
Clean Beans 推送通知

Clean Beans 发送的部分推送示例。

尊重时区的定时发送 \

用户可以选择接收每日提醒的时间。Clean Beans 不会为每个用户单独安排任务。它每小时运行一个任务,并判断“现在是谁的那个时间?”
1

数据库计划任务每小时调用一次函数

pg_cron 向 Supabase Edge Function 发出 HTTP 请求。它所需的服务密钥从 Supabase Vault 读取,因此永远不会出现在 SQL 中。
2

函数找出本地时间匹配的用户

它加载所有开启了该提醒的用户,将当前时间转换为每位用户的时区,并保留所选时间正是现在的用户。
3

检查是否有内容可说

没有到期任务的用户不会收到推送。
4

为每位用户调用一次 OneSignal

每条推送的内容都不同,因此每条都是单独的请求。
计划任务:
supabase/migrations/006_cron_daily_digest.sql
时区匹配:
supabase/functions/send-daily-digest/index.ts
发送:
supabase/functions/send-daily-digest/index.ts
...DELIVERY.daily_digest、idempotency_key 和角标字段在可靠且表现得当的推送中有说明。data.type 字段用于让应用知道点击推送时应打开哪个界面。请参阅深度链接和通知点击。 标题和正文根据任务生成,因此推送内容很具体。
supabase/functions/send-daily-digest/index.ts

逾期提醒:第二次、不一样的提醒 \

逾期提醒沿用同样的模式,只有两处不同。它在用户的摘要时间之后六小时触发,并且只统计确实已过期的任务。
supabase/functions/send-overdue-reminders/index.ts
它的任务在每小时的半点运行,因此不会与整点运行的摘要任务冲突。文案也不同。重复第一条内容的第二条提醒很容易被忽略。
supabase/functions/send-overdue-reminders/index.ts

打扫提醒:一次请求发给多人 \

打扫提醒对每个人说的都是同样的内容,因此不需要为每个人单独请求。函数收集所有符合条件的用户 ID,并分批发送。
supabase/functions/send-cleaning-reminder/index.ts
内容不同时,为每个人发送一个请求。内容相同时,用一个请求发给多人。请求越少,可能出错的地方越少,也越容易遵守速率限制。

会话完成:由应用触发的推送 \

当有人完成打扫会话时,家庭中的其他成员会收到通知。应用不能自己发送这条推送,因为它不能持有 API 密钥。它会调用一个后端函数,由该函数发送推送。
src/lib/database.ts
请求说明了打扫了什么,但没有说明是谁打扫的。函数从调用方的登录令牌中读取其身份,检查其是否为该家庭的活跃成员,并从其资料中获取姓名和头像。请参阅检查调用方。 接着,它找到家庭中的其他成员,并排除关闭了此类推送的人。
supabase/functions/session-completed/index.ts
它向所有这些人发送一条推送。发送者的豆子头像以图片形式附加,并为每个平台使用不同的字段。
supabase/functions/session-completed/index.ts
显示豆子头像图片的展开推送通知

展开后显示发送者头像的会话完成推送。

Kudos:一个人发给另一个人 \

Kudos 的工作方式相同,只有一个接收者。在动态界面中,成员点击室友会话上的 Send Kudos,选择一条消息,应用便会调用 send-kudos 函数。
带有预设消息的 kudos 底部面板

为室友的打扫会话选择一条 kudos 消息。

supabase/functions/send-kudos/index.ts

加入已批准:由数据库触发的推送 \

申请加入家庭的人需要等待管理员批准。批准后,其成员记录会从 pending 变为 active。针对这一变化的数据库触发器会调用一个函数,由该函数告诉对方已经加入。 把触发器放在数据库中,意味着无论通过什么方式批准都会发送推送,应用也不需要为此编写代码。
supabase/migrations/027_join_approved_trigger.sql
函数不会轻信收到的内容。它会重新读取成员记录,只有在批准真实且是最近发生时才发送。
supabase/functions/join-approved/index.ts
按请求发送消息的函数可能会被他人尝试调用。请像这个函数一样,在发送前先在自己的数据库中核实事实,并且绝不要接受来自未经验证的调用方的消息内容或接收者。

检查调用方 \

Supabase 会验证发往 edge function 的请求是否携带有效令牌,但已登录用户的令牌与计划程序的令牌一样有效。如果没有进一步检查,任何用户都可以为所有人触发每日摘要,或冒用他人名义发送推送。因此,每个函数都自行决定允许谁调用它。 计划函数以一行代码开头:
supabase/functions/send-daily-digest/index.ts
supabase/functions/_shared/auth.ts
角色检查依赖于 Supabase 已经验证了令牌签名。部署这些函数时请保持 JWT 验证开启(这是默认设置)。切勿使用 --no-verify-jwt 部署。
从应用调用的函数会根据令牌识别发送者,然后检查发送者是否有权联系接收者。Kudos 只能发给与发送者同属一个家庭的人,推送中显示的名字从发送者的资料中读取。
supabase/functions/send-kudos/index.ts

Create message API

所有渠道的定向、内容和计划。

富媒体

各平台推送通知中的图片。