Descripción General
El endpoint Mensajes Personalizados permite enviar mensajes con formato personalizado a través de Telegram. Este endpoint proporciona flexibilidad para enviar mensajes con diferentes estilos de formato, incluyendo HTML y Markdown.
🎯 Características del Endpoint
- Formato Personalizado: Soporte para HTML y Markdown
- Flexibilidad de Contenido: Mensajes con cualquier contenido
- Modos de Parseo: Diferentes modos de formato disponibles
- Validación de Entrada: Verificación de parámetros de entrada
- Respuesta Estructurada: Respuestas consistentes con otros endpoints
Endpoint Disponible
POST
/api/telegram/custom
Envía un mensaje personalizado con formato opcional. Este endpoint permite enviar mensajes con formato personalizado usando diferentes modos de parseo.
Body (JSON):
{
"message": "Custom formatted message",
"parseMode": "html"
}
200 OK - Mensaje Enviado
Mensaje personalizado enviado exitosamente
{
"success": true,
"message": "Custom message sent successfully",
"timestamp": "2024-01-15T10:30:00Z"
}
400 Bad Request - Error de Envío
Error al enviar el mensaje personalizado
{
"success": false,
"message": "Failed to send custom message",
"timestamp": "2024-01-15T10:30:00Z"
}
Ejemplos de Uso
🔧 Ejemplo con curl - Mensaje HTML
curl -X POST \
'http://localhost:1379/api/telegram/custom' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ "message": "Custom formatted message", "parseMode": "html" }'
🔧 Ejemplo con curl - Mensaje Markdown
curl -X POST \
'http://localhost:1379/api/telegram/custom' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ "message": "**Bold** *italic* message", "parseMode": "markdown" }'
🔧 Ejemplo con curl - Mensaje Plano
curl -X POST \
'http://localhost:1379/api/telegram/custom' \
-H 'accept: application/json' \
-H 'Content-Type: application/json' \
-d '{ "message": "Plain text message without formatting" }'
🔧 Ejemplo con JavaScript
// Mensaje HTML
fetch('/api/telegram/custom', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: 'Hello World!',
parseMode: 'html'
})
})
.then(response => response.json())
.then(data => console.log(data));
// Mensaje Markdown
fetch('/api/telegram/custom', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
message: '**Bold** *italic* text',
parseMode: 'markdown'
})
})
.then(response => response.json())
.then(data => console.log(data));
Servicio Utilizado
ITelegramService.SendCustomMessageAsync(string, string?) - Envía mensaje personalizado
- Parámetro 1: string message - Contenido del mensaje
- Parámetro 2: string? parseMode - Modo de formato (opcional)
- Retorna: bool - true si se envió correctamente
- Funcionalidad: Envía mensaje con formato personalizado