---
title: "Send a message to Empower AI chat"
method: POST
path: "/empower/chat"
tags: ["empower"]
---

# Send a message to Empower AI chat

`POST /empower/chat`

Sends a chat message to the Empower AI assistant in the context of a specific call. The AI uses the call transcription and conversation history to generate a response.

**Permission:** `Empower Read` required.

**Monitoring:** No impact. Visibility depends on your Empower role.

## Request body

- object
  - `chat_history` ChatHistoryItem[], required — Conversation history (array of ChatHistoryItem objects). (optional)
    - `role` string, required — Role of the message sender (e.g., 'assistant' or 'user').
    - `content` string, required — Content of the message.
  - `call_id` string, required — Unique identifier for the call.
  - `related_to` integer[] — List of related call IDs (optional).
  - `related_meet` string, nullable — Identifier of an associated meeting (optional).
  - `message` string, required — Chat message to be sent.
  - `transcription` string[], required — Array of transcription segments. (optional)
  - `user_id` integer, required — User identifier required if checking phone number relationships.

## Response `200`

Successful operation — returns the AI-generated response and the transcriptions used.

- object
  - `transcription` string[] — List of transcriptions considered.
  - `response` string — Response generated by the LLM.

## Other responses

- `400` — Bad request — missing or invalid parameters (e.g. missing call_id or message).
- `401` — Unauthorized — missing or invalid token, or insufficient Empower Read permission.
- `500` — Internal server error.

---

[API](https://skmtc.net/ringover/apis/ringover-public-api.md) · [All operations](https://skmtc.net/ringover/apis/ringover-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringover/ringover-public-api/revisions/9da73dd2f99e/schema)