Overview
The Message Service handles chat messages and AI interactions in the CicloVital application. It provides functionality to retrieve chat messages and send messages to the AI assistant for responses.
API Configuration
The service uses environment-based API URL configuration:
const isProd = import.meta.env.VITE_PROD === 'true';
const API_URL = isProd
? import.meta.env.VITE_URL_API_MESSAGE
: import.meta.env.VITE_URL_API_LOCAL_MESSAGE;
Functions
getMessagesByChatID
Retrieves all messages for a specific chat conversation.
export const getMessagesByChatID = async (chatId) => {
// Implementation
}
The unique identifier of the chat whose messages to retrieve
Response object with message dataSuccess Response:{
ok: true,
data: res.data // Array of message objects
}
{
ok: false,
messageError: err.message // Error message
}
GET
Endpoint: {API_URL}/porChat/{chatId}
Example Usage
import { getMessagesByChatID } from '@/services/messageService';
const chatId = 'chat456';
const result = await getMessagesByChatID(chatId);
if (result.ok) {
console.log('Chat messages:', result.data);
result.data.forEach(message => {
console.log(`${message.sender}: ${message.text}`);
});
} else {
console.error('Error fetching messages:', result.messageError);
}
sendMessageToIA
Sends a message to the AI assistant and receives a response.
export const sendMessageToIA = async (chatId, mensaje, userId) => {
// Implementation
}
The unique identifier of the chat conversation
The message text to send to the AI assistant
The unique identifier of the user sending the message
Response object with AI response dataSuccess Response:{
ok: true,
data: res.data // AI response and message data
}
{
ok: false,
messageError: err.message // Error message
}
POST
Endpoint: {API_URL}/ia
Request Body:
{
chatId: string,
mensaje: string,
userId: string
}
Example Usage
import { sendMessageToIA } from '@/services/messageService';
const chatId = 'chat456';
const userId = 'user123';
const userMessage = '¿Cómo puedo mejorar mi bienestar hoy?';
const result = await sendMessageToIA(chatId, userMessage, userId);
if (result.ok) {
console.log('AI response:', result.data);
const aiMessage = result.data.response;
console.log('AI says:', aiMessage);
} else {
console.error('Error sending message to AI:', result.messageError);
}
Real-World Integration Example
import { sendMessageToIA, getMessagesByChatID } from '@/services/messageService';
// Send a message and update UI
async function handleSendMessage(chatId, userId, messageText) {
// Send message to AI
const result = await sendMessageToIA(chatId, messageText, userId);
if (result.ok) {
// Refresh messages to show both user message and AI response
const messagesResult = await getMessagesByChatID(chatId);
if (messagesResult.ok) {
return messagesResult.data;
}
} else {
throw new Error(result.messageError);
}
}
// Usage in component
const messages = await handleSendMessage('chat456', 'user123', 'Hello!');
Error Handling
All service methods use a consistent error handling pattern:
- Error Source: Returns
err.message from caught exceptions
- Response Format: Always returns
{ ok: boolean, data/messageError }
- Debug Logging: Errors in
sendMessageToIA are logged to console
Notes
- The
sendMessageToIA function processes both user and AI messages on the backend
- AI responses are typically stored in the chat history automatically
- Use
getMessagesByChatID after sendMessageToIA to retrieve the complete conversation
Source Code
Location: src/services/messageService.js