Skip to main content

How to Send a Message

You can send direct (one-on-one) messages to other users. Real-time delivery uses SignalR; you can also use the REST API.

In the app (UI)

  1. Log in and open Messages (e.g. envelope or chat icon in the top bar).
  2. Start a conversation:
    • Use Search to find a user by name or username.
    • Click the user to open a chat (or “New message” then choose the person).
  3. Type your message in the input at the bottom and press Send (or Enter).
  4. Optional: Attach a photo, video, or file using the attachment button; then send.

Messages are delivered in real time. You’ll see sent/delivered/read status if the app supports it.

Via the API

Send a text message:

POST /api/Chat/messages
Authorization: Bearer {token}
Content-Type: application/json

{
"recipientId": "user-guid",
"content": "Hello! How are you?",
"type": "text"
}

Send a media message:
Use POST /api/Chat/upload (or upload-multiple) with recipientId, optional conversationId, and the file in the body (multipart/form-data). See Messaging feature.

For real-time delivery and typing indicators, the app connects to the SignalR chat hub; the REST API is used to send and load messages.

Next steps