---
url: https://docs.ogmabox.com/vi/app/ws-replay.md
description: >-
  Kết nối lại với điểm cuối WebSocket, chỉnh sửa khung và gửi lại tin nhắn đã
  ghi nhận trong Ogma.
---

# WebSocket Replay {#websocket-replay}

WebSocket Replay tạo các phiên có thể tái sử dụng để kiểm thử điểm cuối WebSocket. Dùng để kết nối lại với chi tiết bắt tay đã ghi nhận, chỉnh sửa tin nhắn, gửi khung mới và quan sát phản hồi máy chủ.

## Tạo phiên {#creating-a-session}

Có hai cách tạo phiên WebSocket Replay:

* Nhấp chuột phải vào tin nhắn WebSocket đã ghi nhận trong **Lịch sử WS / SSE** và chọn **Gửi đến WS Replay**.
* Mở **WS Replay** và tạo phiên thủ công với URL `ws://` hoặc `wss://`.

Phiên thủ công có thể chứa header tùy chỉnh cho cookie, token xác thực, thương lượng giao thức hoặc giá trị bắt tay riêng của ứng dụng.

## Thiết lập phiên {#session-setup}

| Trường | Mô tả |
| --- | --- |
| Tên | Nhãn phiên dễ đọc. |
| URL | Điểm cuối WebSocket. URL phải bắt đầu bằng `ws://` hoặc `wss://`. |
| Header | Header bắt tay không bắt buộc, được gửi khi kết nối. |

Nếu bạn đổi URL hoặc header, Ogma lưu phiên trước khi mở kết nối tiếp theo.

## Kết nối {#connecting}

Chọn phiên và nhấp **Kết nối**. Trạng thái kết nối cho biết socket chưa kết nối, đang kết nối, đang mở, đang đóng hay đã đóng.

Dùng **Ngắt kết nối** trước khi đổi mục tiêu hoặc chi tiết bắt tay. Kết nối lại sau khi chỉnh sửa URL hoặc header để kiểm thử đường dẫn máy chủ mới hoặc ngữ cảnh đã xác thực.

Kết nối chỉ hoàn tất bắt tay WebSocket. Sau đó nhiều ứng dụng yêu cầu khung xác thực hoặc khởi tạo trước khi chấp nhận tin nhắn nghiệp vụ. Dùng tin nhắn máy khách đầu tiên đã ghi nhận làm cơ sở, chờ xác nhận của tin nhắn đó, rồi mới gửi tin nhắn đã chỉnh sửa. Cookie đã ghi nhận, URL có chữ ký và token có thể đã hết hạn.

## Gửi tin nhắn {#sending-messages}

Dùng trình soạn tin để chỉnh sửa payload và gửi qua phiên đã chọn. Payload văn bản được gửi dưới dạng khung văn bản WebSocket.

Chuyển sang chế độ nhị phân cho byte thập lục phân. **Phát lại thông điệp WebSocket đầu tiên đã ghi nhận** giúp gửi lại bước khởi tạo, còn **Phát lại chuỗi thông điệp gửi đi đã ghi nhận** gửi các tin nhắn máy khách đã ghi nhận theo thứ tự. Kiểm tra phản hồi trong dòng thời gian thay vì cho rằng gửi chuỗi đã tái tạo trạng thái ứng dụng.

Trình chỉnh sửa giao thức hỗ trợ WebSocket thô và các chế độ GraphQL được quản lý (`graphql-transport-ws` và `graphql-ws` cũ). Chọn giao thức mục tiêu dùng và cung cấp tham số kết nối. Giữ header giao thức con ban đầu khi cần; yêu cầu sai giao thức có thể khiến nâng cấp thất bại.

**Làm mới dấu thời gian** mặc định tắt. Chỉ bật cho yêu cầu không có chữ ký cần dấu thời gian mới: thay URL hoặc payload có chữ ký có thể làm chữ ký mất hiệu lực. **Tự động kết nối lại** thử lại sau khi ngắt kết nối, nhưng kết nối mới vẫn có thể cần xác thực ở cấp ứng dụng.

Tin nhắn đã ghi nhận được gửi từ lịch sử giữ payload gốc làm điểm khởi đầu, để bạn có thể thay từng trường và so sánh hành vi.

## Dòng thời gian tin nhắn {#message-timeline}

Dòng thời gian ghi lại các khung gửi và nhận của phiên được chọn.

| Cột | Mô tả |
| --- | --- |
| Chiều | Khung được máy khách gửi hay nhận từ máy chủ. |
| Opcode | Loại khung, như văn bản, nhị phân, ping, pong hoặc đóng. |
| Kích thước | Kích thước payload. |
| Thời gian | Thời điểm Ogma quan sát khung. |

Chọn tin nhắn để kiểm tra payload. Payload JSON được định dạng khi có thể; nội dung thô vẫn có sẵn để kiểm tra chính xác.

## Quy trình kiểm thử {#testing-workflow}

1. Ghi nhận một luồng WebSocket bình thường trong **Lịch sử WS / SSE**.
2. Gửi tin nhắn máy khách đáng chú ý đến **WS Replay**.
3. Kết nối lại và gửi lại tin nhắn gốc để xác nhận hành vi cơ sở.
4. Mỗi lần chỉnh sửa một trường, token, ID hoặc lệnh.
5. Ghi lại hành vi đã xác nhận trong **Phát hiện** hoặc giữ ghi chú trong **Ghi chú**.

## Khắc phục sự cố {#troubleshooting}

| Triệu chứng | Nội dung cần kiểm tra |
| --- | --- |
| Nâng cấp bị từ chối hoặc cấm | URL, Origin, cookie, xác thực và giá trị truy vấn có chữ ký đã hết hạn. |
| Giao thức con không hợp lệ hoặc không được yêu cầu | So sánh Header nâng cấp với bắt tay đã ghi nhận và chế độ giao thức đã chọn. |
| Kết nối thành công rồi đóng | Kiểm tra tin nhắn hệ thống/đóng và gửi khung khởi tạo hoặc xác thực cần thiết. |
| Tin nhắn đã gửi nhưng không có phản hồi hữu ích | Xác nhận ID đăng ký, tin nhắn trước đó, xác thực và trạng thái ứng dụng; truyền tải WebSocket không tự động tái tạo phiên trình duyệt. |

Với MCP, dùng các công cụ chuyên dụng để liệt kê/đọc tin nhắn và ngắt kết nối WS Replay. Công cụ lịch sử đã ghi nhận đọc một bản ghi trao đổi khác; xem [tài liệu tham chiếu công cụ MCP](../reference/mcp-tools.md#websocket-and-sse).

## Trang liên quan {#related-pages}

* [Lịch sử WebSocket và SSE](./ws-sse-history.md)
* [Replay](./replay.md)
* [Phát hiện](./findings.md)