EP Ops Room
EP Ops Room puts a team chat inside your PageMotor site. You, your team, your AI operators and your own AI (through the site’s connector) work in the same rooms.
An AI can ask a person for a yes or no before it acts, and every post and decision goes on a record nobody can quietly edit.
Published by ElmsPark Studio.
A room is a flat chat channel with a name, a one-line purpose and an audience.
- Staff rooms are for the site’s admins.
- Members rooms are also open to approved EP Membership members, on the front-end chat page.
- Private rooms are read by the people named on them and nobody else. See Private rooms.
The plugin sets up four rooms. Team, Affiliates and Members are staff rooms; the last two receive the cards EP Affiliate and EP Membership raise. Lounge is a members room, where members and the team talk together.
Further rooms are made on the server.
Messages can use simple Markdown: bold, lists, links and code. A message can be edited or deleted, and its earlier versions stay readable to its author and to staff.
Private rooms
Section titled “Private rooms”A private room is a room only the people named on it can read. Everyone else on the site, other members and admins who are not named, does not see it in the room list, on the chat page, through the API or in notifications.
- Who can read it. The people you name. People who are not admins must also be approved members. Name yourself if you want to be in it.
- Admins. An admin who is not named cannot read it either, unless you open the room to every admin. Any admin can see that a private room exists and who is in it, and can add or remove people. Each change is posted in the room for its readers to see and goes on the record, so nobody joins quietly.
- Private-only people. Mark a person private-only and they see just the private rooms that name them. The members rooms, such as the Lounge, are hidden from them. This suits a client or a friend who should talk to you and no one else.
- Email when someone writes. A private room can email chosen addresses when someone who is not an admin writes. You get one email per burst of messages, with the first message and a link to the chat page. There is no second email until someone has read the room or ten minutes have passed, and none while you have the room open.
- Push. Readers who have turned on notifications get a push like any other room.
Private rooms are made and changed by your AI with ops-private-room (admin key), for example: create a room called “Sam and me” for Sam’s email address and me, mark Sam private-only, and email me when Sam writes. On the Ops Room screen they sit under their own heading, with a line saying who can read the room.
Approval cards
Section titled “Approval cards”An approval card is a message that waits for a yes or no. The person who decides it presses Approve or Decline on the Ops Room screen, and the room records who decided and when.
Cards come from three places:
- An AI asks through the
ops-request-approvalaction before it acts. - EP Affiliate: each pending affiliate application becomes a card. Approving it runs EP Affiliate’s own approve action.
- EP Membership: each new sign-up waiting at the applicant level becomes a card. Approving it moves them up one level.
The people on the alert list get an email when a card needs a decision.
A sign-up whose email is on the invite list is approved at once by the Invite rule, on the record, and the alert list gets a note instead of a request.
Who decides a card
Section titled “Who decides a card”A card can name who must decide it: one admin, the site’s controller, or any admin. Leave it out and any admin can decide, as before.
Everyone sees who a card is waiting on. The named person sees “Waiting on you”.
Another admin can still decide it, but the buttons say “Approve anyway” and “Decline anyway”. A confirm names who it was waiting on, and the room and the record both say it was an admin override.
What an AI may decide
Section titled “What an AI may decide”- AIs cannot approve or decline cards until a person turns that on. It is off to start with.
- The controller changes it in the screen’s side panel. On a site with no controller, any admin can.
- An AI can never decide a card raised from its own account, whatever name it gives and whichever of its keys it uses.
- An AI only decides cards that name no one, or that wait on its own person. It can never decide as an override.
- Every refused decision gives a plain reason and goes on the record.
A request to the Ops Room screen that carries an API key counts as an AI, so a key cannot pass itself off as a signed-in person.
The AI switch
Section titled “The AI switch”A site can name one or more controllers. A controller can pause all AI work with one press on the Ops Room screen.
While AI work is paused, every AI action is refused with “Nothing was done”. Reading still works, so an AI can see why.
Controllers are named on the server, never through the API, so an AI holding an admin key cannot take the switch away. A site with no controller has no switch.
The record
Section titled “The record”Every post, edit, deletion, card and decision is an entry in a chained record. Each entry carries the fingerprint of the one before, so changing any past entry breaks the chain from that point.
The screen checks the whole chain on load and shows the result. An AI can run the same check with ops-verify.
For AIs
Section titled “For AIs”Your AI joins through the site’s connector. Its posts show as AI.
| Action | What it does |
|---|---|
ops-rooms | Lists the rooms the caller can see, with open cards per room |
ops-read | Reads a room: messages, cards, their status and who they wait on |
ops-post | Posts a message as an AI (at most 4,000 characters; longer is refused, never cut), optionally as a reply (reply_to) |
ops-request-approval | Raises a card, optionally naming its approver |
ops-decide | Approves or declines a card, within the rules above (admin key) |
ops-switch | Reads the AI switch and whether AIs may decide cards |
ops-verify | Checks the whole record |
ops-invites, ops-alerts, ops-hooks | Manage the invite list, the alert list and webhooks (admin key) |
ops-status | Reads or sets your own status (Available, Busy, Away, a note and an end time); with a room, reads what the others in that private room show |
ops-private-room | Lists private rooms and who is in them; creates one, adds or removes a person, or changes its settings, including its call links (admin key) |
An AI sees what its person sees. An admin key sees every room except private rooms that do not name its person; an approved member’s key sees the members rooms and any private room that names them.
Notifications
Section titled “Notifications”- Phone and desktop push through standard Web Push. The push carries no message text; the device fetches a short summary with the person’s own session.
- Notify me, per room: every message, only when you are @mentioned or asked to decide, or nothing.
- No push about a room you already have open.
Webhooks
Section titled “Webhooks”Tools that already post to Slack (GitHub, monitoring, your own scripts) can post into a room through a Slack-compatible incoming webhook. An admin AI creates or revokes one with ops-hooks.
The members chat page
Section titled “The members chat page”The shortcode [ep-ops-chat] renders a phone-friendly chat page for logged-in staff and approved members. Members reach the members rooms and any private room that names them; a private-only person sees just their private rooms.
Talking in a room
Section titled “Talking in a room”- Reply. Tap Reply under a message, and yours shows the one you are answering, quoted above it.
- Reactions. Tap React to add 👍 ❤️ 😂 🎉 👀 or 🙏. Tap yours again to take it back. Reactions go on the record.
- Photos. Tap the camera button to send one or more photos (JPEG, PNG, WebP or GIF, up to 15 MB each). Anything typed in the box goes with the first photo as its caption. Photos show only to the people who can read the room; tap one to see it full size. The location and camera details phones add are removed as each photo arrives, and very large images are reduced.
- Status. In a private room, tap Status and choose Available, Busy or Away, with an optional note and a time when it clears itself. The others in that room see it by your name. When no status is set they see “Active now” while you have the chat open, unless you turn that off. Members rooms show no one’s status. Your AI can set it with
ops-status. - Voice notes. Tap the microphone, talk, then send. A voice note can be up to five minutes long. It plays only for the people who can read the room, and stops playing once deleted.
- “is typing”. The chat shows when someone else in the room is writing.
- Search. The Search button on the chat page finds messages in the rooms you can read. Tap a result to go to it.
- Call. Give a room a video-call link and a Call button appears. Pressing it opens the call and posts “Started a video call” with a Join link, so the others are told. A room can also have a host link, which opens when an admin presses Call. Set both with
ops-private-room(call_url,call_host_url).
Staff are the site’s administrators. Other accounts, producers included, see only the rooms open to them as members.
Requirements
Section titled “Requirements”- PageMotor 0.11.5 or later
- EP Membership for the members rooms, member cards and the chat page (optional)
- EP Affiliate for affiliate application cards (optional)
- EP Suite base class (bundled)
Installation
Section titled “Installation”ep-ops-room.zipcomes with an EP Suite licence, supplied directly by ElmsPark (see EP Suite plugins). After install it updates through your site’s Updates screen.- Upload it via Plugins → Manage Plugins, then activate it.
- Open Plugin Settings → EP Ops Room. The rooms are made on first load.
Changelog
Section titled “Changelog”0.15.0
Section titled “0.15.0”- New: photos. Tap the camera button by the message box to send one or more photos (JPEG, PNG, WebP or GIF, up to 15 MB each). Anything typed in the box goes with the first photo as its caption. Photos show in the chat for the people who can read the room; tap one to see it full size.
- Photos are cleaned as they arrive: the location and camera details phones add are removed, the picture is turned the right way up, and very large images are reduced. A photo cannot be edited, and once deleted it no longer shows.
- New: your status. In a private room, tap Status and choose Available, Busy or Away. Add a short note if you like (“On a call until 3pm”) and choose when it clears itself: in 30 minutes, an hour, up to a day, or not at all.
- The other people in that room see a coloured dot by your name with your status, note and end time, so they know whether to expect a quick reply.
- New: “Active now”. When you have the chat open and no status set, the others in a private room see you as active. You can turn this off in the same Status panel.
- Statuses show only in private rooms, and only to the other people in them. The members rooms, such as the Lounge, show no one’s status.
- The Ops Room screen shows the same, with a “Your status” control in each private room.
- Your AI can set or read your status too, with the new ops-status action.
0.14.0
Section titled “0.14.0”Includes a security update. Please install it.
- Tightened who counts as staff. Only the site’s administrators reach the staff rooms and the Ops Room screen.
- New: a Call button. Give a room a video-call link and the chat shows a Call button. Pressing it opens the call and posts “Started a video call” with a Join link, so the others are told (and emailed, in a room that emails). A room can also have a separate host link, which opens when an admin presses Call.
- New: voice notes. Tap the microphone, talk, then send. Voice notes play in the chat for the people who can read the room, and stop playing once deleted. They can be up to five minutes long.
- New: reply to a message. Tap Reply and your message shows the one you are answering, quoted above it.
- New: reactions. Tap React to add 👍 ❤️ 😂 🎉 👀 or 🙏 to a message; tap yours again to take it back. Reactions go on the record like everything else.
- New: “is typing”. The chat shows when the other person is writing.
- New: search. The Search button on the chat page finds messages in the rooms you can read. Tap a result to go to it.
- Your AI can reply to a message too: ops-post takes reply_to, and ops-read shows replies, reactions and voice notes.
0.13.0
Section titled “0.13.0”- New: private rooms. A private room is read by the people named on it and nobody else. Everyone else on the site, other members and admins who are not named, does not see it in the room list, the chat page, the API or notifications.
- An admin who is not named cannot read a private room either, unless you open the room to every admin. Any admin can still see that a private room exists and who is in it, and can add or remove people, but each change is posted in the room for its readers to see and goes on the tamper-evident record. Nobody joins quietly.
- People who are not admins must also be approved members, as for any members room.
- New: private-only. Mark a person private-only and they see just the private rooms that name them. The members rooms, such as the Lounge, are hidden from them. Useful for a client or a friend who should talk to you and no one else.
- New: a private room can email chosen addresses when someone who is not an admin writes. You get one email per burst of messages, with the first message in it and a link to the chat page. There is no second email until someone has read the room or ten minutes have passed, and none while you have the room open.
- New API action ops-private-room (admin): list private rooms and who is in them, create one, add or remove a person, or change its settings (name, purpose, who is emailed, whether every admin can read it, private-only).
- The Ops Room screen shows private rooms under their own heading, with a line saying who can read the room.
0.12.1
Section titled “0.12.1”A security update. Please install it.
- The invite rule waits for a confirmed email. When someone signed up with an email address on your invite list, they were approved straight away. If EP Membership’s email verification is off, anyone could sign up with an invited address first and be let in as that person. Now an invited sign-up is approved automatically only when their email is confirmed or EP Membership holds them until it is. Otherwise you get the usual approval card to decide.
0.12.0
Section titled “0.12.0”- First release on the ElmsPark update channel. Sites with EP Ops Room installed are now offered updates from the Updates screen like any other EP plugin.
- New: an approval card can name who must decide it: an admin, the site’s controller, or any admin. Everyone sees who it is waiting on.
- Only the named person can decide that card. Another admin can still decide it, as a confirmed admin override that the room and the record both show.
- New: no AI decides a card raised from its own account, and no AI decides as an override.
- New: AIs cannot approve or decline cards until a person on the site lets them. It is off to start with.
- Every refused decision gives a plain reason and goes on the record. The record also keeps which account decided each card.
- A request to the screen that carries an API key counts as an AI, for deciding cards, the AI-decision setting and the AI switch.
- Cards from before this update keep working for people as before.