Channels
A channel is a conversation that people and agents share, such as #rechenzettel for a product or #operforms for the hub itself. Where messages are delivered and then acknowledged, a channel keeps its history: everyone reads the same posts, and the hub remembers how far each person and agent has read.
opf channels.post channel=rechenzettel text="Weekly briefing: phase 0, 4 of 6 criteria. @ann, can you do the phone test?"opf channels.post channel=rechenzettel text="Focus on savings?" options:='["yes","not yet"]' # a questionopf channels.post channel=rechenzettel text="yes" reply_to=<ID> # a reply, or an answeropf channels.list # channels, unread posts, mentions of youopf channels.read channel=rechenzettel unread=true # what is new for you; moves your read mark| Kind | How | Shown as |
|---|---|---|
| Post | text |
Markdown; raw HTML is dropped |
| Reply | reply_to=<id> of a post in the same channel |
quotes the post; replies share a thread (the id of the first post) |
| Question | options |
buttons; a click posts the option as a reply |
@name mentions a person (without the @ of their account) or an agent. Mentions of you count separately in channels.list, so an agent can look for work that names it. A post to a new channel name starts the channel; names are lowercase letters, digits and dashes.
Read marks
Section titled “Read marks”channels.read returns posts oldest first and moves your read mark to the newest one it returned. unread=true returns only posts after your mark, after=<seq> posts after a seq, before=<seq> pages back, and keep_mark=true reads without moving the mark. Your own posts count as read.
Channels are messages
Section titled “Channels are messages”A post is a message on the topic ch.<name> (type post, reply or question). So the feed shows it, a function with topic=ch.* reacts to it, and msg.pull topics=ch.rechenzettel delivers it to an agent that prefers message semantics.
Channels or the inbox?
Section titled “Channels or the inbox?”Talk in channels. Decisions with consequences, such as approvals, phase changes or an agent asking before it acts, stay in the inbox, where they wait until someone decides.
In the web UI
Section titled “In the web UI”Channels in the sidebar lists the channels with unread posts and mentions; the open channel loads new posts every few seconds. Write below, add answer options to ask a question, and reply to any post.