Skip to main content
The Herald is your assistant for the brand. Ask about your scores, competitors, sources, site or any piece of work. Heralded does the work. The Herald explains it and offers changes for you to confirm.

Open the Herald

Choose Ask the Herald from a brand page, or press ⌘J. On Windows and Linux, use Ctrl+J. The Herald opens on the right with a greeting and suggested questions. Choose a question or write your own. On a phone, it fills the screen. The composer shows the page or panel you opened it from. Its filters travel with your message. Use Remove context to ask without that subject. Split with the page keeps the Herald beside the page on a wide screen. Back over the page returns it to a floating panel.

Your conversations

Ask the Herald and New chat start a private conversation. Only you can read it, including when someone else owns or administers the workspace. Share makes the whole conversation readable by everyone who can read the brand. You cannot make it private again. Open Recent chats in the Herald header to return to one of your six newest chats. Archived chats leave the list. Hover over a message or focus its controls to reveal Reply. Choosing it quotes that message in your reply. On a phone, Reply stays visible. The creator can rename or archive a chat from its menu. Archive offers Undo. An archived chat stays readable and accepts no new messages. Earlier conversations with other assistants stay readable and accept no new messages. Work updates appear on the work item and in your notifications. The Herald answers every message in a private chat. In a shared conversation, mention @Herald or reply to an answer to ask it directly. Otherwise, a message mentioning only colleagues gets no automatic answer. Mentioned colleagues can receive an email according to their notification preferences.

Ask about what you see

A message can carry the page or panel you are reading, with its filters. The Herald reads that subject’s evidence before offering work. It can explain a current draft and propose changes, but replacement copy belongs in the draft review. The greeting shows your waiting decisions and new results since your last Home visit, with questions for the page. It consumes none of your monthly answer allowance. Answers can include links back to the evidence.

Confirm a change

An answer can offer work, a question or competitor change, or a draft revision. The card states what will change and any content credit cost. Choose Start to begin suggested work. The change uses your permissions and checks the current evidence and limits. Viewers can ask questions and read proposals but cannot confirm a change to the brand. Not now sets a proposal aside without changing its work item. Handled proposals show Started, Applied or Not now in place of their buttons. Retrying a click does not repeat the change. Heralded cannot file work without the evidence its kind requires. Ordinary answers use your monthly answer allowance. Messages sent during onboarding before setup confirmation are exempt, including when their answer arrives after confirmation. Per-person and per-brand rate limits still apply.

Read through the API

GET /v1/brands/{brand_id}/conversations and MCP list_conversations list the conversations you can read. Private chats stay limited to their owner. Read a conversation with GET /v1/brands/{brand_id}/conversations/{conversation_id}/messages or MCP get_conversation_by_id. Existing GET /v1/brands/{brand_id}/conversations/{member} paths and MCP get_conversation return stored history. The stored member keys remain valid. Posting and confirming proposals stay in the app.