Support Chat
Yoyo Market (hereinafter “Yoyo”) provides a built-in support chat so you can reach a human operator directly from the platform. The chat works for both authenticated users and anonymous visitors.
Starting a Chat Session
POST /api/v1/chat/session
Creates a new chat session or returns your existing active session. If you are authenticated, the session is linked to your account. Anonymous users receive a session tied to their browser.
Calling an Operator
POST /api/v1/chat/session/call-operator
Notifies the support team that you are waiting for assistance. Use this after creating a session to signal that you need a live operator rather than just browsing previous messages.
Sending Messages
POST /api/v1/chat/message
{
"text": "I have a question about my recent trade."
}
Sends a message in your active chat session. Both you and the operator can send messages through this endpoint.
Viewing Chat History
GET /api/v1/chat/history
Returns the full message history for your current chat session, including messages from both you and the operator with timestamps.
Polling for New Messages
GET /api/v1/chat/poll
Returns new messages since your last poll. Use this endpoint to check for operator replies. The client should poll at a reasonable interval (for example, every few seconds while the chat window is open).
Authentication
The support chat is designed to be accessible to everyone:
- Authenticated users — the session is associated with your account, and the operator can see your profile and trading history to provide better assistance.
- Unauthenticated visitors — you can still open a chat session and communicate with support. The session is tracked by a session identifier.
Summary of Endpoints
| Method | Endpoint | Auth | Description |
|---|---|---|---|
POST | /api/v1/chat/session | Optional | Create or get chat session |
POST | /api/v1/chat/session/call-operator | Optional | Request a live operator |
GET | /api/v1/chat/history | Optional | Get chat message history |
GET | /api/v1/chat/poll | Optional | Poll for new messages |
POST | /api/v1/chat/message | Optional | Send a message |