# Matching link shared

**Event:** `chat.link.shared`

## Description

A newly created text or markdown message contains one or more links that
match this app's registered unfurl domains.

**Event name:** `chat.link.shared`

**Required scope:** `links:read`

Delivered inside the standard [event envelope](/docs/webhooks/webhooks#event-envelope).
URLs are unique, ordered by first appearance, and filtered separately for
each installation. Edits and messages sent by the same app installation do
not produce this event.

The app receives only messages in chats it can see: organization apps must
be chat members or the chat must be a public group; personal installations
require their owner to be in the chat.

## Webhook Payload


### Example Payload

```json
{
  "type": "chat.link.shared",
  "eventId": "0197f9a2-1a51-7aa1-8b2c-3d4e5f6a7b8c",
  "timestamp": "2026-07-20T15:30:00.000000Z",
  "apiVersion": "2026-07-07",
  "data": {
    "chatId": "8f3b9c2e-1a4d-4e7b-9c0a-2b6d1f5e3a7c",
    "chatType": "group",
    "messageId": "16933dd4-6e4c-4acf-9af1-d1972f9b4d34",
    "messageTimestamp": 1748906400000000,
    "userId": "ad1e9cc0-0ffd-47e5-895c-2630a73327b4",
    "links": [
      {
        "url": "https://status.example.com/incidents/123",
        "domain": "status.example.com"
      }
    ]
  }
}
```

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/webhooks/chat-link-shared*