> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automate.ax/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# Get message transcription

> Returns the transcription for a supported message.

`highlevel.getMessageTranscription` returns the transcription for a supported message.

```ts automations/highlevel-get-message-transcription.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { highlevel } from "automate.ax/highlevel"

export default automation("Get message transcription", () => {
  markSignificant(
    highlevel.getMessageTranscription({
      messageId: "tDtDnQdgm2LXpyiqYvZ6",
    }),
  )
})
```

## Input

| Field       | Type     | Required | Description                 |
| ----------- | -------- | -------- | --------------------------- |
| `messageId` | `string` | Yes      | HighLevel message id value. |

Automate.ax supplies the connected sub-account's location ID. Optional second argument `{ account }` selects a named HighLevel binding.

## Output

| Field           | Type     | Required | Description                                          |
| --------------- | -------- | -------- | ---------------------------------------------------- |
| `mediaChannel`  | `number` | Yes      | Media channel describes the user interaction channel |
| `sentenceIndex` | `number` | Yes      | Index of the sentence in the transcription           |
| `startTime`     | `number` | Yes      | Start time of the sentence in milliseconds           |
| `endTime`       | `number` | Yes      | End time of the sentence in milliseconds             |
| `transcript`    | `string` | Yes      | Transcript of the sentence                           |
| `confidence`    | `number` | Yes      | Confidence of the transcription                      |

This action calls `GET /conversations/locations/{locationId}/messages/{messageId}/transcription` with HighLevel API version `2021-04-15` and requires `conversations/message.readonly`. HighLevel validation and permission errors fail the action. Rate limits honor the provider's retry timing.