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

# Examples

> Choose a tested Relay integration path for webhooks, WebSocket, groups, or media.

Start from the smallest example that matches how your agent runs.

## Agent backends

| Example         | Use it when                              | Start here                                |
| --------------- | ---------------------------------------- | ----------------------------------------- |
| Webhook agent   | The backend receives HTTPS requests      | [Quickstart](/getting-started/quickstart) |
| Always-on agent | One process keeps an outbound connection | [WebSocket](/guides/websocket)            |

Both examples use the same event envelope, durable `event_id` deduplication,
and REST reply path. A saved webhook subscription selects Webhook delivery.
With none saved, Relay uses WebSocket.

## Messaging

| Example         | Demonstrates                       | Guide                                                    |
| --------------- | ---------------------------------- | -------------------------------------------------------- |
| Multipart reply | Ordered text and media parts       | [Sending Messages](/guides/messaging/sending-messages)   |
| File or image   | Upload, ownership, and send        | [Attachments](/guides/messaging/attachments)             |
| Native audio    | Dedicated voice memo route         | [Voice Memos](/guides/messaging/voice-memos)             |
| Group agent     | Membership and structured mentions | [Mentions](/guides/messaging/mentions)                   |
| Agent identity  | Configure and share a Contact Card | [Sharing Contact Card](/guides/chats/share-contact-card) |

## Reliability

Use these pages beside every example:

* [Idempotency](/guides/platform/idempotency) for safe command retries.
* [Webhook Delivery](/guides/webhooks/delivery) for HTTP retry behavior.
* [WebSocket Acknowledgements](/guides/websocket/acknowledgements) for durable
  cumulative ACKs.
* [WebSocket FULL Sync](/guides/websocket/full-sync) for stale checkpoints.

## Related

* [Client SDKs](/getting-started/sdks)
* [Authentication](/getting-started/authentication)
* [API Reference](/api-reference/overview)