Workspace

Workspace log: find out why a customer got no reply

Find out why a customer got no reply, why a run took a branch, or why WhatsApp refused a message, from 30 days of what Heythere did.

A customer of the online shop says they never got the Ember jacket news, and the shop asks its agent why. The agent reads the workspace log, which records what Heythere did and received for a workspace, so it can explain what happened to a contact: why a message started no automation, why a run took a branch, or why WhatsApp refused a message. Heythere keeps each entry 30 days.

What does the log record?

Every entry concerns one contact, and the conversation and run it is about, if any:

  • Exchanges with WhatsApp: what Heythere asked WhatsApp, and what WhatsApp answered or notified, with WhatsApp's error codes.

  • Exchanges with the AI provider: what an AI model was asked, what it answered, and what it cost.

  • HTTP requests: what an http_request step sent, secrets left as placeholders, and what it received.

  • Routing: where each message went and why, such as automation_unpublished before its automation is published.

  • Billed conversations: the delivered message that started each billed conversation.

  • Run decisions: what each run sent, how it judged each reply, the values it wrote, the branch or exit it took, and why it ended.

  • Internal errors: an unexpected failure of Heythere.

How does an agent read the log?

Start from the narrowest ID, here the customer's contact. listWorkspaceLog narrows the log to one contact, conversation, run, or message, to some kinds of entries, or to a window of time.

When the log shows an error it does not explain, such as an internal error, file a bug report that names the entry's traceId.

In the API

Every operation is a REST endpoint and, unless marked REST only, an MCP tool of the same name. The OpenAPI document describes their parameters, payloads, and errors.

  • GET

    listWorkspaceLog

    List the workspace log

    /api/organizations/{organizationId}/workspaces/{workspaceId}/log