Fjord

Documentación de Fjord

Módulos

04

Inserciones

Crea mensajes estructurados con el editor visual sin escribir JSON.

Funciones incluidas

  • Títulos, descripciones, campos y contenido multimedia
  • Vista previa durante la edición
  • Guardar y volver a editar

¿Qué puedes crear con las inserciones?

Diseña mensajes de Discord en el editor visual y compruébalos en la vista previa. Combina texto, campos, imágenes y colores, guarda borradores o publica mensajes en un canal y actualízalos más tarde.

Comprensión de las composiciones

Ambos formatos admiten vista previa, colores de acento, imágenes, varias inserciones y desplegar, copiar, eliminar y ordenar inserciones. V1 usa campos fijos de Discord y V2 bloques libres. Los siguientes apartados explican las entradas y sus diferencias.

El nombre de una composición solo se usa para la administración en el panel y no se envía a Discord. Por servidor se pueden almacenar hasta 50 composiciones con nombres de un máximo de 50 caracteres cada uno.

EstadoComportamiento
BorradorSin un canal de destino, la composición se guardará pero no se publicará en Discord.
Publicación administradaCon el canal de destino, guardar crea un mensaje de Discord asociado permanentemente con la composición. Otros cambios actualizarán este mensaje exacto.
Enviar una vezEnvía el mensaje actual sin guardar la composición ni crear un enlace posterior. Esta opción solo existe antes del primer guardado.

Componentes V1 / V2

Las composiciones nuevas empiezan en V2.

Elige V1 o V2 antes de guardar por primera vez. Después, la versión es permanente, también en borradores y tras retirar la publicación. Crea una composición nueva para otro formato. Duplicar conserva la versión. Los mensajes V1 guardados no se convierten ni eliminan automáticamente.

V1

V1 usa inserciones clásicas de Discord con color de acento y secciones fijas. Admite hasta diez inserciones. La tabla indica el máximo de caracteres. Autor, título, descripción, pie y todos los nombres y valores de campos pueden sumar como máximo 6000 caracteres entre todas las inserciones. El texto normal tiene un límite separado. Cada inserción V1 admite hasta 25 campos.

EntradaLímite de caracteresEstado
Autor256Opcional
URL del autor512Opcional
Título256Opcional
Enlace del título (opcional)512Opcional
Descripción4096Opcional
Texto del pie2048Opcional
Nombre del campo256Obligatorio al añadir
Valor del campo1024Obligatorio al añadir

Todas las secciones de diseño son opcionales. Al añadir un campo, su nombre y valor son obligatorios. Elimina los campos sin usar. La disposición en paralelo activa campos en línea, cuya distribución final depende de Discord y del ancho de pantalla. El enlace o icono de autor necesita un nombre de autor, el enlace del título necesita un título y el icono de pie necesita texto de pie. Los enlaces opcionales deben ser direcciones HTTP(S) completas. La marca de tiempo muestra el momento del envío.

Los selectores de roles y canales están disponibles en el texto normal, la descripción V1 y los valores de campo. No aparecen en autor, título, pie ni nombres de campo. Puedes usar emojis del servidor en esos textos. La URL de autor y el enlace de título solo admiten URL, sin roles, canales ni emojis. Las menciones en inserciones clásicas no notifican.

V2 agrupa hasta cinco botones de enlace por fila de acciones. Se aplica el límite total de componentes, no el límite V1 de cinco filas.

Los botones de enlace abren páginas web y no asignan roles. Cada botón añadido requiere una etiqueta de hasta 80 caracteres y una URL HTTP(S) completa de hasta 512 caracteres. El emoji es opcional. Se pueden ordenar y eliminar. V1 los muestra bajo las inserciones con cinco botones por fila y cinco filas como máximo, es decir, 25 botones. V2 los coloca en su contenedor y cuenta botones y filas dentro del límite de 40.

Crear composición

El nombre interno es obligatorio incluso al guardar un borrador. El editor admite 50 caracteres. Las composiciones nuevas reciben un nombre sugerido editable. Solo aparece en el panel. Publicar requiere un canal accesible y texto visible, una inserción o un botón de enlace completo. Una descripción o imagen no necesita título. Un borrador vacío aún no necesita contenido.

Derechos de Discord requeridos

Ver canal Enviar mensajes Insertar enlaces Adjuntar archivos Mencionar @everyone, @here y todos los roles

En V1, las menciones del texto normal pueden notificar, pero las inserciones clásicas no. En V2, los bloques de texto también pueden generar menciones. Para @everyone, @here y roles no mencionables por todos, Fjord necesita el permiso correspondiente de Discord. Revisa las menciones antes de publicar.

Ver canal y Enviar mensajes son necesarios para publicar. Insertar enlaces se requiere para inserciones clásicas y sus imágenes. Adjuntar archivos es necesario al enviar archivos de imagen locales una sola vez. Guardar un borrador no publica aún un mensaje Discord.

  1. Abre Inserciones en el panel.
  2. Seleccione Nueva composición y asigne un nombre interno.
  3. Agregue contenido de mensaje normal si es necesario.
  4. Diseñe la primera incorporación y agregue incrustaciones adicionales si es necesario.
  5. Comprueba el resultado en la vista previa de Discord.
  6. Elija un canal de destino para la publicación o déjelo en blanco para guardar solo un borrador.
Nombre de la composiciónObligatorio

Se utiliza exclusivamente para la administración en el panel de control y puede contener un máximo de 50 caracteres.

Contenido del mensajeOpcional

El contenido normal es opcional y admite hasta 2.000 caracteres. Se puede publicar únicamente texto. El mensaje debe tener contenido visible. Comprueba también los límites del formato y de componentes.

IncrustaciónOpcional

Las inserciones son opcionales. Puedes diseñar hasta diez. En V2, el presupuesto compartido de componentes también limita su cantidad y contenido.

Canal de destinoOpcional

Sin un canal de destino, se guarda un borrador. Un canal de destino accesible es obligatorio para la publicación.

Contenido del mensaje

El contenido normal del mensaje aparece encima de los elementos insertados y puede contener hasta 2000 caracteres. Los roles, canales y emojis del servidor se pueden utilizar mediante la selección en el editor.

En V1, las menciones del texto normal pueden notificar, pero las inserciones clásicas no. En V2, los bloques de texto también pueden generar menciones. Para @everyone, @here y roles no mencionables por todos, Fjord necesita el permiso correspondiente de Discord. Revisa las menciones antes de publicar.

Diseño de incrustaciones

Discord solo muestra el icono del autor si también se ha indicado un nombre. Introduce un nombre arriba para que el icono aparezca en la vista previa. Discord solo muestra el icono del pie si también hay texto de pie. Introduce un texto arriba para que el icono aparezca en la vista previa.

V2

Un bloque de imagen puede contener una galería de hasta diez imágenes. Usa “+ Otra imagen” para añadir imágenes y eliminarlas individualmente. Cada imagen y miniatura tiene una descripción opcional de hasta 80 caracteres y una opción de spoiler. Una sección admite hasta tres textos de hasta 4000 caracteres cada uno. Usa “+ Otro texto” para añadir hasta dos textos adicionales. En Accesorio puedes elegir una miniatura o un botón de enlace. El botón requiere una etiqueta de hasta 80 caracteres y una URL HTTP(S) completa de hasta 512 caracteres. El emoji y la desactivación son opcionales. Los textos adicionales y el botón accesorio cuentan para el límite de componentes. Las imágenes individuales de una galería no cuentan como componentes adicionales.

En V2 puedes marcar los contenedores y las imágenes, incluidas las miniaturas, como spoilers. Su contenido queda oculto hasta que se hace clic.

V2 ofrece hasta diez contenedores con colores propios. Usa bloques de texto o secciones con miniatura opcional a la derecha, cada uno con hasta 4000 caracteres y Markdown. Los separadores muestran una línea o solo espacio, pequeño o grande. Añade, copia, elimina y ordena bloques con las flechas. Los bloques de texto e imagen vacíos no producen contenido visible. Los textos V2 ofrecen selectores de roles, canales y emojis del servidor.

V2 no tiene campos clásicos de autor, entradas de enlace de título, campos en línea, iconos de pie ni interruptor de marca de tiempo. Usa Markdown para títulos y enlaces. El ejemplo siguiente crea un pie pequeño y el token de tiempo añade la fecha. V1 no ofrece bloques V2 libremente ordenados. No se mezclan ambos formatos en un mensaje.

-# ... · {time.full}

Contenedor

Colores rápidos · 10

Bloque de texto

Markdown · 4000

Sección con miniatura

Markdown · 4000 · Thumbnail ≤ 5 MB

Imagen

PNG · JPG/JPEG · WebP · GIF ≤ 10 MB

Separador

Mostrar línea divisoria · Pequeño / Grande

V2 tiene un límite conjunto de 40 componentes por mensaje. Cuentan los contenedores, textos, secciones, miniaturas, galerías, separadores, filas de acciones, botones y menús. Las opciones de menú no cuentan individualmente. Los separadores y controles añadidos automáticamente también consumen el límite. Por ejemplo, un contenedor con texto, imagen, separador y botón con su fila usa seis componentes. Los diez contenedores no pueden llenarse sin límite.

Usar imágenes

Los límites de imagen son por archivo. En V1, icono de autor, miniatura e icono de pie admiten 5 MB cada uno. La imagen grande tiene el mismo límite que los bloques V2 indicado abajo. Se admiten PNG, JPG/JPEG, WebP y GIF. Elegir archivo reemplaza una imagen y Eliminar vacía el espacio. Los iconos de autor y pie no aparecen sin su texto correspondiente.

Elige PNG, JPG/JPEG, WebP o GIF. Las imágenes se suben al guardar. Las miniaturas admiten hasta 5 MB y los bloques de imagen hasta 10 MB. El envío único en el módulo de incrustaciones permite diez imágenes locales con un total de 20 MB.

Thumbnail5 MB
Imagen10 MB

Guardar y publicar

Si el mensaje gestionado ya falta en Discord, guardar de nuevo lo publica otra vez. Una composición duplicada conserva el formato, empieza sin canal de publicación y es independiente del original.

Guardar como borrador

Deje la selección de canal en blanco y guárdela. El borrador permanece disponible en el panel sin crear un mensaje de Discord.

Publicar permanentemente

Seleccione un canal y guárdelo. El mensaje de Discord creado permanece vinculado a la composición. Los cambios posteriores se actualizarán en el mismo mensaje cuando se guarden.

Aplazar publicación

Si eliges un canal diferente para una composición que ya ha sido publicada, la próxima vez que la guardes, primero se creará el nuevo mensaje y luego se eliminará el anterior.

Eliminar publicación

Eliminar publicación solo elimina el mensaje de Discord administrado. La composición permanece como un borrador guardado.

Eliminar composición

Eliminar una composición borra el registro guardado y sus imágenes almacenadas. No borra el mensaje ya enviado en Discord, que puede perder referencias de imagen. Si también quieres quitar el mensaje gestionado, retira primero su publicación explícitamente. Los mensajes de envío único no se gestionan después.

Administrar y duplicar

Las composiciones guardadas se pueden abrir, cambiar de nombre, duplicar y eliminar. Se pueden crear, reorganizar y duplicar hasta diez incrustaciones dentro de una composición. Se evita la duplicación si al hacerlo se exceden los límites de número o texto de Discord.

Puedes cambiar entre las composiciones y la vista general dentro del módulo. Los cambios sin guardar se conservan. Antes de salir del módulo, guarda o descarta todos los cambios pendientes. La barra de guardado común sigue visible en la vista general. Guardar aplica todos los cambios pendientes de las composiciones. Cancelar los descarta. Esto también incluye composiciones que no están abiertas en ese momento.

Reparar errores

ObservaciónExamen
El mensaje no se puede publicar.¿Se ha seleccionado un canal de texto accesible y Fjord puede enviar mensajes e insertar allí?
Se rechaza una imagen.Elige PNG, JPG/JPEG, WebP o GIF. Las imágenes se suben al guardar. Las miniaturas admiten hasta 5 MB y los bloques de imagen hasta 10 MB. El envío único en el módulo de incrustaciones permite diez imágenes locales con un total de 20 MB.
Enviar una vez no está disponible.La función solo está disponible antes del primer guardado y está limitada a diez archivos adjuntos locales.
No se menciona ninguna función.En V1, las menciones del texto normal pueden notificar, pero las inserciones clásicas no. En V2, los bloques de texto también pueden generar menciones. Para @everyone, @here y roles no mencionables por todos, Fjord necesita el permiso correspondiente de Discord. Revisa las menciones antes de publicar.
El canal guardado ya no está disponible.Seleccione un canal existente en el que Fjord pueda publicar y guárdelo nuevamente.

Marcadores de composiciones

Usa los siguientes marcadores en el texto normal de ambas versiones y los campos clásicos V1. Se sustituyen al enviar o actualizar, no continuamente. Actualmente los marcadores de servidor, canal y bot no se sustituyen en bloques V2. Allí funciona el token de tiempo descrito arriba. Los marcadores de miembro y avatares dinámicos pertenecen a bienvenida.

{member.guild.member_count}Número de miembros
{guild.owner.mention}Mención del propietario
{member.guild.name}Nombre del servidor
{guild.owner.id}ID del propietario
{channel.mention}Mención del canal de destino
{time.relative}Tiempo relativo
{channel.id}ID del canal de destino
{bot.mention}Mención del bot
{time.full}Fecha y hora
{guild.id}ID del servidor
{bot.name}Nombre del bot
{bot.id}ID del bot

Requisitos y límites

No hace falta rellenar todas las secciones opcionales. Solo un color o bloques vacíos no aportan contenido visible para publicar. La vista previa no envía mensajes ni sustituye una prueba en el canal. Ningún editor ofrece encuestas, stickers, formularios ni acciones programables. Los datos y opciones disponibles dependen también de tus permisos en el panel.

Vista previa, spoilers y archivos de imagen

En la vista previa V2, una imagen de galería conserva su proporción. Varias imágenes forman una cuadrícula con recortes iguales de 16:9. Dos o cuatro imágenes usan dos columnas, tres y entre cinco y diez usan tres columnas. La miniatura aparece a la derecha del texto de la sección. La descripción proporciona texto alternativo, no un pie de imagen visible adicional.

Los interruptores de spoiler de imagen y contenedor pertenecen al editor V2. Las imágenes de galería y miniaturas pueden ocultarse por separado. El spoiler de un contenedor oculta su contenido y mantiene visible el marco exterior. Un clic revela la vista previa sin cambiar el ajuste guardado. Los miembros también pueden revelar los spoilers haciendo clic en Discord.

Las imágenes de mensajes admiten PNG, JPG/JPEG, WebP y GIF. El tipo de archivo debe coincidir con su contenido. Cambiar la extensión de un archivo HTML o SVG no lo convierte en una imagen compatible. Los límites de las tablas siguen aplicándose por archivo. Si una imagen local se rechaza o ya no puede leerse, selecciona de nuevo el archivo original y vuelve a guardar.

Los campos de texto Markdown admiten enlaces web y de correo. La vista previa abre enlaces HTTP(S) y mailto, pero no enlaces a archivos locales ni direcciones Blob. Los enlaces de autor, título y botones requieren URL HTTP(S) completas. La vista previa no publica mensajes. Comprueba el resultado guardado en Discord, cuya presentación puede variar según el cliente y el ancho de pantalla.