Backend Developer Guide

POST /api/admin/auth/login

{
  "email": "admin@example.com",
  "password": "<your_password>"
}

Response (200 OK):

{
  "success": true,
  "token": "...",
  "user": {
    "id": "user_id",
    "email": "admin@example.com",
    "role": "SYSTEM_SUPER_ADMIN",
    "businessId": "business_id"
  }
}

POST /api/messenger/auth/login

{
  "email": "user@business.com",
  "password": "<your_password>",
  "businessId": "business_id"
}

Response (200 OK):

{
  "success": true,
  "token": "...",
  "user": {
    "id": "user_id",
    "email": "user@business.com",
    "name": "John Doe",
    "businessId": "business_id"
  }
}

POST /api/messenger/messages

{
  "recipientId": "user_id",
  "content": "Hello! How are you?",
  "type": "text",
  "attachments": []
}

Response (201 Created):

{
  "success": true,
  "message": {
    "id": "msg_id",
    "senderId": "your_id",
    "recipientId": "user_id",
    "content": "Hello! How are you?",
    "type": "text",
    "timestamp": "2025-11-22T10:30:00Z",
    "read": false
  }
}

Receive Message

socket.on('message:received', (data) => {
  console.log(data)
  // {
  //   id: "msg_id",
  //   senderId: "user_id",
  //   content: "Hello!",
  //   senderName: "John",
  //   timestamp: "2025-11-22T10:30:00Z"
  // }
})

// Send read receipt
socket.emit('message:read', {
  messageId: "msg_id"
})

POST /api/messenger/calls

{
  "recipientId": "user_id",
  "callType": "video",  // or "audio"
  "roomId": "room_123"
}

Response (201 Created):

{
  "success": true,
  "call": {
    "id": "call_id",
    "callerId": "your_id",
    "callerName": "You",
    "receiverId": "user_id",
    "receiverName": "John Doe",
    "receiverAvatar": "https://...",
    "callType": "video",
    "roomId": "room_123",
    "status": "ringing",
    "createdAt": "2025-11-22T10:30:00Z"
  }
}

Incoming Call Event

socket.on('call:incoming', (data) => {
  // {
  //   callId: "call_id",
  //   callerId: "caller_id",
  //   callerName: "John Doe",
  //   callerAvatar: "https://...",
  //   callType: "video",
  //   roomId: "room_123"
  // }
})

// Accept call
socket.emit('call:accept', { callId: "call_id" })

// Reject call
socket.emit('call:reject', { callId: "call_id" })

// End call
socket.emit('call:end', { callId: "call_id" })

GET /api/admin/users?businessId=business_id

Response (200 OK):
{
  "success": true,
  "users": [
    {
      "id": "user_id",
      "email": "user@business.com",
      "name": "John Doe",
      "role": "BUSINESS_ADMIN",
      "businessId": "business_id",
      "avatar": "https://...",
      "status": "active",
      "createdAt": "2025-11-22T10:30:00Z"
    }
  ],
  "total": 45,
  "page": 1
}

POST /api/admin/users

{
  "email": "newuser@business.com",
  "name": "Jane Smith",
  "password": "<your_password>",
  "role": "BUSINESS_ADMIN",
  "businessId": "business_id"
}

Response (201 Created):

{
  "success": true,
  "user": {
    "id": "new_user_id",
    "email": "newuser@business.com",
    "name": "Jane Smith",
    "role": "BUSINESS_ADMIN",
    "businessId": "business_id"
  }
}

Presence Updates

// Listen for users coming online
socket.on('user:online', (userId) => {
  console.log('User came online:', userId)
  // Update UI to show user as online
})

// Listen for users going offline
socket.on('user:offline', (userId) => {
  console.log('User went offline:', userId)
  // Update UI to show user as offline
})

// Get list of online users
socket.on('users:online', (userIds) => {
  console.log('Online users:', userIds)
  // {
  //   users: ["user1_id", "user2_id"]
  // }
})

Send Typing Indicator

// User started typing
socket.emit('typing:start', {
  recipientId: "user_id"
})

// Listen for typing indicator
socket.on('typing:indicator', (data) => {
  // { userId: "user_id" }
  console.log('User is typing...')
})

// User stopped typing
socket.emit('typing:stop', {
  recipientId: "user_id"
})