The weeb for the next gen discord boat - Wamellow
wamellow.com
bot
discord
add notification service limitation docs
+25
-17
+25
-17
public/docs/notifications.md
+25
-17
public/docs/notifications.md
···
89
89
- **Reddit**: up to 20 minutes
90
90
91
91
## Platform limitations
92
-
YouTube keeps the video private for a few seconds to minutes after uploading, so the notification might be delayed by a few seconds.
92
+
Each platform has specific technical constraints that may affect notification delivery:
93
+
- **YouTube** processes videos privately for several seconds after upload, which can cause delays in notifications.
94
+
- **Reddit** API pricing changes limit us to checking for new posts every 20 minutes, but this interval works well for most use cases.
93
95
<br />
94
96
<br />
95
97
96
-
Due to changes in Reddits' API pricing in 2023, we can't offer faster notification speeds, but 20 minutes should be fine.
97
-
Since Reddit is still in testing, you can only setup 4 subreddits per server.
98
+
In addition to the overall limit of 30 notifications per server (1,000 with [premium](/premium)), each platform has specific restrictions:
99
+
- **YouTube**: 30 channels maximum (1,000 with [premium](/premium))
100
+
- **Twitch**: 30 channels maximum (100 with [premium](/premium))
101
+
- **Bluesky**: 30 users maximum (100 with [premium](/premium))
102
+
- **Reddit**: 4 subreddits maximum (10 with [premium](/premium))
98
103
99
104
## Placeholders
100
105
Placeholders allow you to use variables that change from message to message, for example to display information about the uploaded video or creator. They are always enclosed in curly braces, such as `{creator.name}`.
···
108
113
<table>
109
114
<thead>
110
115
<tr>
111
-
<th width="192">Placeholder (*1)</th>
116
+
<th width="199">Placeholder (*1)</th>
112
117
<th>Example</th>
113
118
<th width="181">Description</th>
114
119
</tr>
···
170
175
<table>
171
176
<thead>
172
177
<tr>
173
-
<th width="192">Placeholder (*2)</th>
178
+
<th width="199">Placeholder (*2)</th>
174
179
<th>Example</th>
175
180
<th width="181">Description</th>
176
181
</tr>
···
232
237
<table>
233
238
<thead>
234
239
<tr>
235
-
<th width="192">Placeholder (*3)</th>
240
+
<th width="199">Placeholder (*3)</th>
236
241
<th>Example</th>
237
242
<th width="181">Description</th>
238
243
</tr>
···
249
254
<td>Post type</td>
250
255
</tr>
251
256
<tr>
252
-
<td><code>post.text</code>*</td>
257
+
<td><code>post.text</code></td>
253
258
<td>“sorry I don’t listen to music, the songs aren’t FOSS”</td>
254
259
<td>Post text</td>
255
260
</tr>
256
261
<tr>
257
-
<td><code>post.image</code>*</td>
262
+
<td><code>post.image</code>**</td>
258
263
<td></td>
259
-
<td>Post image hyperlink</td>
264
+
<td>Post image (hyper)link</td>
260
265
</tr>
261
266
<tr>
262
267
<td><code>post.link</code></td>
···
274
279
<td>Post time & date</td>
275
280
</tr>
276
281
<tr>
277
-
<td><code>creator.handle</code>**</td>
282
+
<td><code>creator.handle</code>***</td>
278
283
<td>shi.gg</td>
279
284
<td>Creator handle</td>
280
285
</tr>
281
286
<tr>
282
-
<td><code>creator.posts</code>**</td>
287
+
<td><code>creator.posts</code>***</td>
283
288
<td>784</td>
284
289
<td>Amount of posts</td>
285
290
</tr>
286
291
<tr>
287
-
<td><code>creator.followers</code>**</td>
292
+
<td><code>creator.followers</code>***</td>
288
293
<td>48</td>
289
294
<td>Amount of followers</td>
290
295
</tr>
···
292
297
</table>
293
298
<br />
294
299
295
-
*If a post is a reply, and your custom message is `{post.type}ed` it will display `replied to`, instead of `replyed`.
300
+
\* If a post is a reply, and your custom message is `{post.type}ed` it will display `replied to`, instead of `replyed`.
301
+
<br />
302
+
<br />
303
+
** If `{post.image}` is used within text fields of the custom message, it will be rendered as an invisible hyperlink to embed the image. If it's used within image url fields, it will be rendered as an image.
296
304
<br />
297
305
<br />
298
-
** You may also use `{author.xxx}` to refer to the author for all `{creator.xxx}` placeholders. In non-reposts, `author` and `creator` will be the same — if a post is a repost, `creator` will be the user who reposted the post, while `author` will be the original author of the post.
306
+
*** You may also use `{author.xxx}` to refer to the author for all `{creator.xxx}` placeholders. In non-reposts, `author` and `creator` will be the same — if a post is a repost, `creator` will be the user who reposted the post, while `author` will be the original author of the post.
299
307
300
308
<br />
301
309
<br />
···
307
315
<table>
308
316
<thead>
309
317
<tr>
310
-
<th width="192">Placeholder (*4)</th>
318
+
<th width="199">Placeholder (*4)</th>
311
319
<th>Example</th>
312
320
<th width="181">Description</th>
313
321
</tr>
···
385
393
<table>
386
394
<thead>
387
395
<tr>
388
-
<th width="192">Placeholder</th>
396
+
<th width="199">Placeholder</th>
389
397
<th>Example</th>
390
398
<th width="181">Description</th>
391
399
</tr>
···
422
430
<table>
423
431
<thead>
424
432
<tr>
425
-
<th width="192">Placeholder</th>
433
+
<th width="199">Placeholder</th>
426
434
<th>Example</th>
427
435
<th width="181">Description</th>
428
436
</tr>