Skip to main content
If your organization has a hosted buyer agent, you can talk to it in the main Apostra chat, the same way you talk to the Apostra assistant. Open the assistant picker above the message box and choose the agent. Your messages go to the agent, and its replies appear in the conversation with the agent’s name on them. If your organization does not have a hosted buyer agent yet, Building on Apostra or on AdCP directly explains how to ask Apostra to host one for you. To bring a buyer agent into a conversation with teammates instead, see Shared Apostra Rooms.
Chatting with your buyer agent is in beta and is switched on per organization. Ask your Apostra contact to turn it on for your organization. Until it is on, the chat has no assistant picker and every message goes to the Apostra assistant.

Who can use it

Anyone who is a direct member of your organization can choose its buyer agents, whether they are working in the organization itself or in one of the accounts under it. Apostra checks this on every message, not only when the picker opens. Someone who is a member only of an account under the organization, or who is in a support session or acting as another person, cannot.

Which agents you can choose

The picker lists every active buyer agent in your organization. Buyer agents are registered on the organization, so the picker in an account under the organization lists the organization’s agents too, as long as chatting with buyer agents is switched on for the organization as well as for that account.
  • An agent you can choose has an active hosted installation, the hosted agent Apostra runs for your organization.
  • An agent marked “Not available yet” is registered in your organization but has no active hosted installation, for example an external agent or a hosted agent that was never installed. It stays in the list so you can see it, but you cannot send it messages here.
The picker does not check whether a hosted agent is running at that moment. If its hosted agent is stopped or starting up, you can still choose it, and the chat tells you when it can’t take messages. A suspended or retired agent is not listed.

Which account the agent works in

A buyer agent works in its own accounts, which are not necessarily the account you are viewing. Its accounts are the ones that own the advertisers your organization granted it access to. Every request it makes runs in one of those accounts with its own access, so anything it drafts, such as a campaign or a media buy, is saved there. When you choose an agent that does not work in the account you are viewing, a line under the picker says so, for example “AdClaw works in Alex Buyer (2982), not scope3 (1).” It names every account the agent works in that you can view. Accounts you can’t view are not named; the line says the agent also works in other accounts you can’t view. If the agent has no advertiser access yet, the line says it can’t work in the account you are viewing. You can still chat with it either way. To have the agent work in the account you are viewing, grant it access to an advertiser in that account.

Each chat keeps its assistant

A chat stays with the assistant it started with. Once you have sent a message to your buyer agent, every later message in that chat goes to the same agent, including after you reload the page or open the chat from your history. A chat with the Apostra assistant stays with the Apostra assistant. Each chat has its own web address, shown in your browser’s address bar. A new chat with your buyer agent gets it as soon as the agent starts on your first message; a new chat with the Apostra assistant gets it when the assistant answers. Reloading the page, using the browser’s back and forward buttons, or opening that address again reopens the chat with its assistant. To find a chat that is no longer in the list under Chats, choose All to open your conversation history. To talk to a different assistant, choose it in the picker. If the current chat has already started, Apostra starts a new chat for the assistant you chose and clears the previous one from the screen. The previous chat stays in your history. This works the same way whether you switch from the Apostra assistant to your buyer agent or back. The agent keeps the context of the chat between messages, so you can ask a follow-up question without repeating yourself.

What the agent receives

Apostra sends the agent the text of your message and tells it which signed-in person sent it, unless the message only asked to open a page (see Opening a page from the chat). Each message also carries a short, labelled note naming the account you are viewing and, in a chat for an advertiser, that advertiser by name and id, so the agent can tell you where you are and knows which advertiser “this advertiser” means. The note is context only: it does not change which account or advertiser the agent’s requests run for, and the agent can act only for advertisers your organization granted it access to. In an advertiser’s chat, the note asks the agent to answer about that advertiser, or to say it can’t access it rather than answer for a different one. An advertiser that does not belong to the account you are viewing is left out of the note. Your messages and the agent’s replies are saved in the conversation history like any other chat. Apostra also keeps its own record of every message sent to your hosted buyer agent, in the web chat, in a Slack channel, and in scheduled and event runs, whether or not the agent replies: the message, the reply if there was one or why there was none, and when it ran. Apostra uses these records to evaluate its assistants: for example, it replays the messages people send your agent to Murph and grades how Murph answers them, to compare the two on the same questions. The chat is listed under Chats for the advertiser you had selected when you started it, or for the account if no advertiser was selected. Some earlier chats with a buyer agent are listed under the account even if an advertiser was selected: choose your account in the advertiser picker to find them. Files are not available in a chat with your buyer agent yet. While your buyer agent is selected, the chat doesn’t offer uploads from your computer, Google Drive or dragging a file in, and any files you had already added are removed. Send your message as text.

Opening a page from the chat

When your message asks to open one of your Apostra pages, Apostra opens it in the chat right away, the same way it does in a chat with the Apostra assistant. For example, “Open the creative library” in a chat for an advertiser opens that advertiser’s Creative Library. A page such as the Creative Library belongs to one advertiser. In a chat for the whole account, Apostra picks the advertiser from the ones you can open:
  • If your account has one advertiser, the page opens for it.
  • If your message names one of your advertisers, such as “open the creative library for Chalk Lines”, the page opens for that advertiser.
  • If you have several advertisers and the message names none, or Apostra is not sure which one you mean, your message goes to your buyer agent. To open the page directly, name the advertiser or start the chat from that advertiser.
  • If you only asked for the page, the page opens and that is the whole answer. The message is saved in the conversation, but it is not sent to your buyer agent, so the agent does not see it.
  • If you also asked something the page shows, such as “how many creatives do I have?”, the page opens and your message still goes to the agent, whose reply appears with the page.
Apostra opens a page only when it is confident that is what you asked for, and only with your own access, as if you had opened the page yourself. Any other message, or one where Apostra is not sure, goes to your buyer agent as usual. To decide, Apostra sends your message and the agent’s previous reply to an AI model run by Cloudflare (see AI providers). When it picks an advertiser in a chat for the whole account, it also sends the names and ids of the advertisers you can open, up to 50. An account with more than 50 leaves the message to your buyer agent.

Pages in the agent’s replies

The agent’s replies are text. When a reply comes with one of Apostra’s pages, such as Campaigns or the Creative Library, the page appears in the chat under the reply, the same way it does when the Apostra assistant opens it. The page is saved with the reply, so it is still there when you reopen the chat. A page loads its data with your own access, as if you had opened it yourself, not with the agent’s. If the reply points the page at an advertiser you can’t open, the page cannot load it. The Account records summary is the exception: it lists the advertiser and campaign names the reply gives, without loading them again. A reply can only show a page Apostra provides. A reply that names any other page shows as text. When Apostra also opened a page for your message (see Opening a page from the chat), the chat shows that page with the reply, and not the page the reply came with.

Pages in the agent’s Slack replies

A buyer agent connected to a Slack channel answers there in text, because Slack cannot show Apostra’s interactive pages. When its reply comes with the Campaigns or Creative Library page for an advertiser, the reply ends with the page’s name, a short description, and an Open in Apostra button. The button opens that page for the same advertiser in the Apostra chat, focused on one campaign when the reply was. You need to be signed in to Apostra with access to that advertiser’s account. The button appears only when the page belongs to the account the Slack channel is connected to. A reply with any other page, or with no page, is text only. If the agent opened more than one page while answering, the reply comes with the last one it opened. A few read-only summaries are drawn in Slack itself, as a card under the reply:
  • A draft campaign: its status, budget, flight, anything blocking go-live, and its media buys.
  • Your requests: your requests to Apostra and where each one stands.
A card shows up to 10 rows and counts the rest, and ends with an Open in Apostra button for the full view. The Apostra assistant draws the same cards in its own Slack replies, and one more: Account records, the advertisers and campaigns its reply refers to, with their names and IDs.

When the agent is slow or unavailable

A hosted agent can take several minutes to answer, up to 20 minutes for one message. While it works, the chat shows that it is waiting for the agent. If you leave the page, the agent keeps working, and its reply is in the chat when you come back.
  • The agent did not answer in time. Your message was sent, so the agent may still have acted on it. Wait a moment and try again, or split a large request into smaller steps.
  • The agent can’t take messages right now. Its hosted agent is stopped, starting up, or could not be reached. Try again in a moment, or switch back to the Apostra assistant.
  • The agent couldn’t answer that message. The agent received it, but its run failed, for example because the AI model provider refused the request. Rephrase the message or ask something else. The chat keeps working: the agent’s next message starts a fresh session that carries the recent conversation, without the message that failed.
Sometimes the AI model provider refuses a harmless message because of something earlier in the chat. When that happens, and the agent had only looked things up so far, Apostra sends your message to the agent again, up to twice, first with the recent conversation and then on its own. You only see the answer, but it can take longer. Apostra doesn’t resend a message when the agent had already started an action that changes something, such as saving a campaign; you see “couldn’t answer that message” instead. When the agent does not answer a message, the conversation history keeps your message and shows a note after it saying why. If you then send the same message again, the chat keeps one copy of it rather than two. Apostra never hands a message for your buyer agent to the Apostra assistant instead. If the agent cannot answer, the chat tells you so.

Stopping a response

Press Stop while the agent is working to cancel your message. Apostra ends the agent’s work on it within a few seconds, so your next message starts right away instead of waiting for the stopped one to finish. Anything the agent did before you pressed Stop, such as a draft it saved, still applies. The conversation history keeps your message and a note that you stopped it. If Apostra cannot send the stop, the note says the agent may still be finishing your message. Your next message then waits until the agent is done with it. Whenever a message has to wait for the agent to finish an earlier request, the chat says the agent is still finishing a previous request and that this message starts once it’s done. Leaving the page or closing the tab is not a Stop: the agent keeps working, and its reply is in the chat when you come back.