Every message between Camille and her repair shop's WhatsApp number sits in one conversation, between one contact and one number of the workspace. Heythere creates it when the contact first writes there or a broadcast first messages them. A message is inbound when the contact sent it, and outbound when an automation run, a broadcast, a member, or a verification sent it, whose code never shows.
When does a conversation's reply window close?
WhatsApp lets a business send any message for 24 hours after the contact's latest message, until replyWindowClosesAt. If Camille last wrote at 10 a.m. on Monday, the shop answers freely until 10 a.m. on Tuesday. After that, it sends only a message template Meta approved.
Which messages does a contact send?
Texts, images, videos, documents, audio, voice notes, places, contact cards, the reply button or list row they tapped, and reactions. Any other message, such as a sticker, is unsupported. An automation reads Camille's voice note through its transcript, which AI writes, unless its transcribesVoiceNotes is false.
Where does an inbound message go?
To the members during a live chat or after a handover. Otherwise to the conversation's active run, which reads it only while waiting for a reply. Without an active run, it starts the number's published automation. A reaction never starts or continues a run.
How does Heythere send a message?
When the shop tells Camille her bike is ready, the message's state starts at sending, then follows WhatsApp's reports, up to read. A message that never reaches her ends failed, with a reason, such as reply_window_closed when it needed a template.
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
listWorkspaceConversationsList workspace conversations
/api/organizations/{organizationId}/workspaces/{workspaceId}/conversations - GET
listConversationMessagesList conversation messages
/api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/messages - GET
watchWorkspaceConversationsREST onlyWatch workspace conversations
/api/organizations/{organizationId}/workspaces/{workspaceId}/conversation-changes - GET
getMessageMediaREST onlyGet message media
/api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/messages/{messageId}/media