Skip to content

Notification configuration notes

dgtlmoon edited this page Dec 1, 2023 · 21 revisions
  • Be sure that your notification body contains atleast something, often {base_url} will be empty, an empty notification body often causes problems with many notification targets
  • Make sure you're not exceeding your target notification service message length when using {current_snapshot}, {diff} or {diff_full} tokens

ARMv7 (RaspberryPi 3 etc)

Discord and Telegram notifications are not super reliable on these devices, this is an issue for apprise not for changedetection.io

Looks like there's an issue with some ARMv7 devices https://github.com/dgtlmoon/changedetection.io/issues/217#issuecomment-1013917577 https://github.com/dgtlmoon/changedetection.io/discussions/366 - this is not fixable by my and has something todo either with the cross platform docker system or apprise

Also https://github.com/dgtlmoon/changedetection.io/issues/407 (rPi "permission denied")

Discord

Email

Example

Your SMTP server is located at mail.mycompany.com and your target email address is steve@gmail.com

You would specify it as mailto://<from-including-smtp-server>?to=email

mailto://john@mail.mycompany.com/?to=steve@gmail.com

For more help - see the Apprise email info https://github.com/caronc/apprise/wiki/Notify_email

POST/POSTS

version (0.45.8.2+)

You can create arbitrary HTTP POST notifications using post:// or posts:// (SSL). To include a header - like for example if you need an authentication header, it needs to be added to the URL as &+custom-header=hello

For example

posts://service.com?yes=please&+custom-header=hello

custom-header will be stripped from the URL and only used as a header, but you need to prefix it with + to declare it as a header.

Forms/HTTP POST support

This is for doing an actual HTTP webform style subsmission.

JSON

Use the jsons:// notification type and simply set the body in the "Notification body"

See note about headers in the POST/POSTS section

GET/PLAIN API

See https://github.com/caronc/apprise/wiki/Notify_Custom_JSON#get-parameter-manipulation for the special syntax