---
title: "Get list of talk messages that mention the calling agent"
method: GET
path: "/service_agents/talk_mentions"
tags: ["Service Agent"]
---

# Get list of talk messages that mention the calling agent

`GET /service_agents/talk_mentions`

## Request

- Base URL: `https://api.voipbin.net/v1.0`
- URL: `https://api.voipbin.net/v1.0/service_agents/talk_mentions`
- Auth: none declared
- TypeScript: <https://skmtc.dev/voipbin/apis/voipbin-api/docs/service_agents/talk_mentions/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the talk messages in which the calling agent is mentioned, newest first.
A mention is written in the message text as `[@display name](mention:<agent-id>)`; the server records it when the message is created.
Only messages created after this feature was deployed are listed; earlier messages are not indexed.
Messages in chats the agent cannot access (a direct or group chat the agent is not a participant of), deleted messages and messages of deleted chats are not returned.
The mention of the author by the author is not recorded, and at most 50 distinct agents are recorded for one message.

## Query parameters

- `page_size` integer
- `page_token` string

## Response `200`

A list of talk messages that mention the calling agent.

- object
  - `next_page_token` string: Cursor token for the next page of results. Pass this value as the page_token parameter in the next request.
  - `result` TalkManagerMessage[]
    - `id` string, uuid: The unique identifier of the message. Returned from the `POST /service_agents/talk_messages` or `GET /service_agents/talk_messages` response.
    - `customer_id` string, uuid: The unique identifier of the customer who owns this message. Returned from the `GET /customers` response.
    - `owner_type` string: Resource's owner type.
    - `owner_id` string, uuid: The unique identifier of the message author. Returned from the corresponding owner resource endpoint.
    - `chat_id` string, uuid: The unique identifier of the talk this message belongs to. Returned from the `GET /service_agents/talk_chats` response.
    - `parent_id` string, uuid: The unique identifier of the parent message (for threaded replies). Returned from the `GET /service_agents/talk_messages` response.
    - `type` 'normal' | 'system': Type of the message.
    - `text` string: Message text content.
    - `medias` TalkManagerMedia[]: Media attachments.
      - `type` 'address' | 'agent' | 'file' | 'link': Type of the media content.
      - `address` CommonAddress: Contains source or destination detail info.
        - `type` '' | 'agent' | 'conference' | 'email' | 'extension' | 'line' | 'sip' | 'tel' | 'web_session': Type of address.
        - `target` string: The address endpoint. Format depends on type: phone number for tel (e.g. +14155551234), UUID for agent/conference/extension, email for email, SIP URI for sip.
        - `target_name` string: Address's name.
        - `name` string: Optional label for this address.
        - `detail` string: Additional notes about this address.
      - `agent_id` string, uuid: The unique identifier of the agent. Valid only if the type is `agent`. Returned from the `GET /agents` response.
      - `file_id` string, uuid: The unique identifier of the file. Valid only if the type is `file`. Returned from the `GET /storage_files` response.
      - `link_url` string, uri: The URL of the linked resource. Valid only if the type is `link`.
    - `metadata` TalkManagerMetadata
      - `reactions` TalkManagerReaction[]: List of reactions on the message.
        - `emoji` string: Emoji character for the reaction.
        - `owner_type` string: Type of the owner who reacted.
        - `owner_id` string, uuid: The unique identifier of the owner who reacted. Returned from the corresponding owner resource endpoint (e.g., `GET /agents`).
        - `tm_create` string, date-time: Timestamp when the reaction was created.
    - `tm_create` string, date-time: Timestamp when the message was created.
    - `tm_update` string, date-time: Timestamp when the message was last updated.
    - `tm_delete` string, date-time: Timestamp when the message was deleted.

## Other responses

- `401`: Authentication required (UNAUTHENTICATED).
- `403`: Insufficient permission (PERMISSION_DENIED).
- `500`: Internal error (INTERNAL).

## Changes

- **2026-11-03** `bf2741af69c6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voipbin/apis/voipbin-api/changes/service_agents/talk_mentions/get.md)

---

[API](https://skmtc.dev/voipbin/apis/voipbin-api.md) - [All operations](https://skmtc.dev/voipbin/apis/voipbin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/voipbin/apis/voipbin-api/revisions/a3618cfd2159?raw)