> Every page of the Heythere docs is listed in https://heythere.io/docs/llms.txt: fetch it to find a page instead of guessing its URL.

# Live chats: answer WhatsApp customers yourself

> Answer a customer yourself, from the Heythere app or the API, when an automation hands you the conversation or whenever you choose, then hand it back.

Camille asks her repair shop whether they can also fix her gears, a question the shop's automation leaves to a person. A live chat is the workspace's members answering a [contact](https://heythere.io/docs/concepts/contacts) themselves in a [conversation](https://heythere.io/docs/concepts/conversations), from the Heythere app or the API. While it lasts, the contact's messages go to the members and start no [run](https://heythere.io/docs/concepts/runs).

## How does a live chat start?

With a member's first message to the contact, sent with `sendConversationMessage`. It cancels the conversation's active run.

An automation asks for one with a `handover` [step](https://heythere.io/docs/concepts/steps): its run ends `handed_over`, and the conversation awaits a member. Until one writes, Camille's messages start no run, and the conversation shows its `handover`.

## Who is notified?

The Heythere iPhone app notifies the workspace's members of a handover, then the member who started the live chat of each message the contact sends.

## What can members send?

Text, while the conversation's reply window is open: WhatsApp refuses any other message outside it. `showConversationTyping` shows Camille that a member is typing.

## How does a member hand the contact to an automation?

With `startAutomationRun`, such as when Camille asks to join the waitlist for the next repair slot. The [automation of the conversation's number](https://heythere.io/docs/concepts/triggers#which-automation-answers-a-number-) runs as if its `message.received` trigger had received her latest message. `getConversationAutomation` says whether it can start.

## When does a live chat end?

When a member ends it with `endLiveChat` or starts an automation, or when the reply window closes, 24 hours after the contact's latest message. The contact's next message then goes to the number's automation again, as does every message once a handover's reply window closes without a member answering.

## In the API

Every operation is a REST endpoint and, unless marked REST only, an MCP tool of the same name. [The OpenAPI document](https://app.heythere.io/api/openapi.json) describes their parameters, payloads, and errors.


- `sendConversationMessage`: Send conversation message. `POST /api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/messages`
- `showConversationTyping`: Show conversation typing. `POST /api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/typing`
- `endLiveChat`: End live chat. `POST /api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/live-chats/{liveChatId}/end`
- `startAutomationRun`: Start automation run. `POST /api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/automation/runs`
- `getConversationAutomation`: Get the conversation's automation. `GET /api/organizations/{organizationId}/workspaces/{workspaceId}/conversations/{conversationId}/automation`
