Skip to content

Announcements

With a licence key that includes announcements (licence keys), admins post short notices for everyone on the instance, such as "The office is closed on Friday". This needs a server built with the ee features.

Who writes and who reads

  • Admins write, edit, pin and delete every announcement.
  • A writer group can write too: choose one under the announcement settings. Its members write announcements and change or delete their own. Guests and kiosk displays in that group still only read.
  • Everyone who can see the widget reads the announcements: members, admins, and guests and kiosk displays whose shared tab has the widget.
  • Members and admins mark announcements as read; unread ones are highlighted. Read marks belong to each person and are removed with the account.

What an announcement has

  • A title (up to 120 characters) and a text in Markdown (up to 10,000).
  • Pinned announcements stay at the top; the rest are newest first.
  • An optional expiry: afterwards the announcement leaves the widget and is kept in the archive (GET /api/announcements?archive=1) until someone deletes it.
  • Notify: when set on publishing, the announcement goes once to the notification channels under the type announcement. Editing does not notify again unless the author sets it again.

At most 50 announcements can be current at the same time.

Post to Slack or Teams

With a licence key that also includes chat-apps, the author can post an announcement to one of the Slack or Teams channels set up under Settings → Notifications (notifications). The post carries the title, the text and, with PUBLIC_URL set, a link back to the announcement on the start page.

  • It is posted once, when the announcement is published. Editing does not post again unless the author chooses the channel again.
  • The channel's own rules (severity, types, quiet hours) do not apply: the author chose it.
  • If Slack or Teams does not take the post, the announcement is still saved and the answer says so in postError; saving again does not post twice.
  • No additional access to Slack or Teams is needed: it uses the channel's webhook.

With an expired licence key or too few seats, announcements stay readable, but nothing can be written. Writes are listed in the audit log.

API

Method Path
GET /api/announcements Current announcements; ?archive=1 the expired ones. Each has read (for the asking person) and editable.
GET /api/announcements/me {mayWrite}: whether the signed-in account may write, to offer the button
POST /api/announcements {title, body, pinned, expiresAt, notify, postTo}; postTo is a channel ID from /api/announcements/channels
PUT /api/announcements/{id} Same fields
DELETE /api/announcements/{id}
POST /api/announcements/{id}/read Marks it read for the signed-in member or admin
GET /api/announcements/channels The Slack and Teams channels a writer can post to; empty without chat-apps
GET, PUT /api/announcements/settings {writerGroup}, a group ID or empty; admins only