Welcome to MontajesMS API
A comprehensive management system for refrigeration chambers with integrated AI chat support.
This documentation describes all available endpoints and how to use them.
Framework
Spring Boot
Database
MySQL
Production Base URL
api.montajesms.cl
GET
/api/servicios
Get all services
Description
Retrieves the complete list of available services offered by MontajesMS.
Success Response (200)
[
{
"id": 1,
"nombre": "Refrigeration Chambers",
"descripcion": "Installation and maintenance of refrigeration chambers",
"precio": 5000
},
{
"id": 2,
"nombre": "Maintenance Services",
"descripcion": "Preventive and corrective maintenance",
"precio": 2500
}
]
GET
/api/servicios/:id
Get specific service details
Parameters
id (number) - Service identifier
Success Response (200)
{
"id": 1,
"nombre": "Refrigeration Chambers",
"descripcion": "Installation and maintenance of refrigeration chambers",
"precio": 5000
}
POST
/api/servicios
Create a new service
Request Body
{
"nombre": "New Service Name",
"descripcion": "Service description",
"precio": 5000
}
Success Response (201)
{
"id": 3,
"nombre": "New Service Name",
"descripcion": "Service description",
"precio": 5000
}
PUT
/api/servicios/:id
Update an existing service
Parameters
id (number) - Service identifier
Request Body
{
"nombre": "Updated Service Name",
"descripcion": "Updated description",
"precio": 6000
}
Success Response (200)
{
"id": 1,
"nombre": "Updated Service Name",
"descripcion": "Updated description",
"precio": 6000
}
GET
/api/contactos
List all contacts
Description
Retrieves the complete list of all registered contacts in the system.
Success Response (200)
[
{
"id": 1,
"nombre": "John Doe",
"telefono": "+56912345678",
"correo": "john@email.com",
"servicio": "Refrigeration",
"mensaje": "Need a quote"
}
]
GET
/api/contactos/:id
Get contact by ID
Parameters
id (number) - Contact identifier
POST
/api/contactos
Create new contact (generates ticket)
Description
Creates a new contact entry and automatically generates a support ticket for tracking.
Request Body
{
"nombre": "John Pérez",
"telefono": "+56912345678",
"correo": "john@email.com",
"servicio": "Refrigeration",
"mensaje": "Need a quote for installation"
}
Success Response (201)
{
"id": 5,
"nombre": "John Pérez",
"telefono": "+56912345678",
"correo": "john@email.com",
"servicio": "Refrigeration",
"mensaje": "Need a quote for installation",
"ticket": "CNT-1234567890-ABC123XY"
}
PUT
/api/contactos/:id
Update contact information
Parameters
id (number) - Contact identifier
Request Body
{
"nombre": "Updated Name",
"telefono": "+56987654321",
"correo": "newemail@email.com"
}
GET
/api/soporte
List all support requests
Description
Retrieves all technical support requests in the system.
Success Response (200)
[
{
"id": 1,
"nombre": "Maria González",
"telefono": "+56987654321",
"email": "maria@email.com",
"tipo_servicio": "Refrigeration",
"descripcion_problema": "Equipment not cooling properly",
"estado": "pending",
"fecha_creacion": "2024-03-01T10:30:00Z"
}
]
GET
/api/soporte/:id
Get support ticket by ID
Parameters
id (number) - Support ticket identifier
POST
/api/soporte
Create a new support request
Description
Creates a new technical support ticket for problem resolution.
Request Body
{
"nombre": "Maria González",
"telefono": "+56987654321",
"email": "maria@email.com",
"tipo_servicio": "Refrigeration",
"descripcion_problema": "Equipment not cooling properly"
}
Success Response (201)
{
"id": 10,
"nombre": "Maria González",
"telefono": "+56987654321",
"email": "maria@email.com",
"tipo_servicio": "Refrigeration",
"descripcion_problema": "Equipment not cooling properly",
"estado": "pending",
"ticket": "SUP-1234567890-DEF456YZ"
}
POST
/api/soporte/postventa
Create post-sale support request
Description
Creates a post-sale support request for warranty or extended service inquiries.
Request Body
{
"nombre": "Robert Smith",
"telefono": "+56912345678",
"email": "robert@email.com",
"numero_serie": "MS-2024-001",
"tipo_servicio": "Maintenance",
"descripcion": "Post-sale maintenance and warranty inquiry"
}
PUT
/api/soporte/:id
Update support ticket status
Parameters
id (number) - Support ticket identifier
Request Body
{
"estado": "resolved",
"respuesta": "Problem fixed by replacing compressor",
"fecha_resolucion": "2024-03-02T15:30:00Z"
}
GET
/api/garantias
List all warranty requests
Description
Retrieves all warranty claims in the system.
Success Response (200)
[
{
"id": 1,
"nombre": "Pedro Silva",
"numero_orden": "ORD-2024-001",
"descripcion_problema": "Panel with leak",
"tipo_garantia": "materials",
"estado": "pending",
"fecha_creacion": "2024-03-01T12:00:00Z"
}
]
GET
/api/garantias/:id
Get warranty request by ID
Parameters
id (number) - Warranty request identifier
POST
/api/garantias
Create a new warranty claim
Description
Creates a new warranty claim for product defects or damages.
Request Body
{
"nombre": "Pedro Silva",
"numero_orden": "ORD-2024-001",
"descripcion_problema": "Panel with leak",
"tipo_garantia": "materials"
}
Success Response (201)
{
"id": 8,
"nombre": "Pedro Silva",
"numero_orden": "ORD-2024-001",
"descripcion_problema": "Panel with leak",
"tipo_garantia": "materials",
"estado": "pending",
"ticket": "GAR-1234567890-GHI789AB"
}
PUT
/api/garantias/:id
Update warranty claim status
Parameters
id (number) - Warranty request identifier
Request Body
{
"estado": "approved",
"observaciones": "Approved for replacement",
"fecha_resolucion": "2024-03-03T10:00:00Z"
}
GET
/api/seguimiento/:ticket
Track support ticket status
Description
Retrieves the current status and details of a support ticket for real-time tracking.
Parameters
ticket (string) - Ticket number
Example: CNT-1234567890-ABC123XY
Success Response (200)
{
"ticket": "CNT-1234567890-ABC123XY",
"estado": "in_progress",
"progreso": 65,
"asignado_a": "John Support",
"descripcion": "Installation in progress",
"fecha_creacion": "2024-03-01T08:00:00Z",
"fecha_estimada_cierre": "2024-03-05T18:00:00Z",
"historial": [
{
"fecha": "2024-03-01T08:00:00Z",
"estado": "created",
"descripcion": "Ticket created"
},
{
"fecha": "2024-03-02T10:30:00Z",
"estado": "assigned",
"descripcion": "Assigned to technician"
}
]
}
POST
/api/chat/message
Send message to AI Chat
Description
Sends a message to the AI chatbot and receives an intelligent response about services and support.
Request Body
{
"sessionId": "user-123-session",
"message": "What services do you offer?",
"usuarioNombre": "John"
}
Success Response (200)
{
"sessionId": "user-123-session",
"response": "MontajesMS offers refrigeration chamber installation, maintenance services, warranty support, and 24/7 technical assistance.",
"timestamp": "2024-03-01T14:30:00Z"
}
POST
/api/chat/feedback
Send chat feedback
Description
Allows users to provide feedback on the AI chat response quality with a rating.
Request Body
{
"sessionId": "user-123-session",
"rating": 5,
"comentario": "Excellent service and quick response"
}
Success Response (201)
{
"id": 45,
"sessionId": "user-123-session",
"rating": 5,
"comentario": "Excellent service and quick response",
"timestamp": "2024-03-01T14:35:00Z"
}
GET
/api/chat/history/:sessionId
Get chat conversation history
Description
Retrieves the complete conversation history for a specific chat session.
Parameters
sessionId (string) - Session identifier
Success Response (200)
{
"sessionId": "user-123-session",
"messages": [
{
"id": 1,
"role": "user",
"content": "What services do you offer?",
"timestamp": "2024-03-01T14:30:00Z"
},
{
"id": 2,
"role": "assistant",
"content": "MontajesMS offers refrigeration chamber installation...",
"timestamp": "2024-03-01T14:30:05Z"
}
]
}