WebSocket Events

Connection Setup

Connect to the Socket.IO server and authenticate with your JWT token:

import { io } from 'socket.io-client';

const socket = io('https://visitnote-api-production.up.railway.app', {
  transports: ['websocket'],
  autoConnect: true,
});

// Authenticate after connecting
socket.emit('userConnect', {
  token: 'YOUR_JWT_TOKEN',
  token_panel: 'therapist',
});

Python Example

import socketio

sio = socketio.Client()
sio.connect('https://visitnote-api-production.up.railway.app', transports=['websocket'])

sio.emit('userConnect', {
    'token': 'YOUR_JWT_TOKEN',
    'token_panel': 'therapist',
})

Common Patterns

Listing Conversations

// Request conversations
socket.emit('getConversations', {
  sender_id: 'your-user-uuid',
  sender_role: 'therapist',
});

// Listen for response
socket.on('conversationsList', (data) => {
  console.log('Conversations:', data.data);
});

Sending and Receiving Messages

// Join a chat room
socket.emit('joinChat', { conversation_uuid: 'conv-uuid' });

// Send a message
socket.emit('sendMessage', {
  conversation_uuid: 'conv-uuid',
  message: 'Hello, how are you feeling?',
  message_type: 'text',
  content_text: 'Hello, how are you feeling?',
});

// Listen for incoming messages
socket.on('receivedMessage', (data) => {
  console.log('New message:', data.data);
});

// Leave when done
socket.emit('leaveChat', { conversation_uuid: 'conv-uuid' });

Typing Indicators

// Send typing status
socket.emit('typing', {
  conversation_uuid: 'conv-uuid',
  is_typing: true,
});

// Listen for other user's typing
socket.on('typing', (data) => {
  if (data.is_typing) {
    showTypingIndicator();
  } else {
    hideTypingIndicator();
  }
});