Get conversation context for a contact

GET

https://api.hmsovereign.com/api/v1/chats/context

Chats

Last modified:2026-04-23 10:43:17

Maintainer:Not configured

Return the last N messages for a contact in chronological order (oldest → newest).

The response contains two views:

messages: raw message rows ready to map into an LLM chat array.

formatted: a single string (ROLE: content per line) convenient to append to a voice agent's system prompt for cross-channel continuity.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Responses

🟢200

application/json

Conversation context

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.hmsovereign.com/api/v1/chats/context?contact_id&agent_id&limit' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "contact_id": "string",
    "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
    "messages": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "agent_id": "2b1e3b65-2c04-4fa2-a2d7-467901e98978",
            "contact_id": "+31612345678",
            "channel": "whatsapp",
            "role": "user",
            "content": "string",
            "metadata": {
                "provider_message_id": "wamid.ABC",
                "attachments": []
            },
            "created_at": "2019-08-24T14:15:22.123Z"
        }
    ],
    "formatted": "USER: When does my order arrive?\nASSISTANT: Your order ships tomorrow."
}

Modified at 2026-04-23 10:43:17

Delete a chat message

Error