Documentación

Aprende TicketsX más rápido

Guías de instalación, la referencia completa de comandos, las funciones Premium y la API REST en un solo sitio.

13.11

Actualizar un panel

PATCH/<guild_id>/api/panels/<panel_id>

Cambia la configuración de un panel: nombre, mensaje embed, color, estilo de los botones y si ignora el cierre automático. El mensaje del panel publicado en Discord se refresca automáticamente. Requiere el permiso `manage_panels` (desactivado por defecto).

Cuerpo de la petición (todos los campos son opcionales, envía solo lo que quieras cambiar)

NombreTipoObligatorioDescripción
panel_titlestring|null
opcional
Título del embed (256 caracteres máx.). Envía null para vaciarlo.
panel_descriptionstring|null
opcional
Descripción del embed (4096 caracteres máx.). Envía null para vaciarla.
panel_contentstring|null
opcional
Texto plano encima del embed (2000 caracteres máx.). Envía null para vaciarlo.
panel_footerstring|null
opcional
Texto del pie del embed (2048 caracteres máx.). Envía null para vaciarlo.
panel_colorstring|null
opcional
Color del embed en hexadecimal, por ejemplo #5865F2. Envía null para vaciarlo.
panel_image_urlstring|null
opcional
Imagen del embed como URL http(s). Envía null para vaciarla.
panel_thumbnail_urlstring|null
opcional
Miniatura del embed como URL http(s). Envía null para vaciarla.
panel_namestring
opcional
Nombre del panel que se usa para nombrar los tickets (100 caracteres máx.). Solo en paneles simples.
button_textstring|null
opcional
Etiqueta del botón (80 caracteres máx.). Solo en paneles simples.
button_colorstring
opcional
Estilo del botón: primary, secondary, success o danger. Solo en paneles simples.
button_emojistring|null
opcional
Emoji del botón (unicode o ID de emoji personalizado). Solo en paneles simples.
disabledboolean
opcional
Desactiva o reactiva el panel. Solo en paneles simples.
bypass_auto_closeboolean
opcional
Deja los tickets de este panel fuera del cierre automático, aunque esté activado para el servidor. Solo en paneles simples.
dropdown_placeholderstring|null
opcional
Texto de ayuda del desplegable (150 caracteres máx.). Solo en paneles múltiples.

Los ajustes estructurales (canal del panel, categoría de tickets, rol a mencionar, formularios, equipos de soporte) no se pueden cambiar por la API; usa el panel para eso. La respuesta incluye message_refreshed. Si vale false (o cambiaste dropdown_placeholder en un panel múltiple), llama a "Reenviar un panel" para actualizar el mensaje de Discord.

Los paneles que usan un diseño con componentes rechazan panel_title, panel_description, panel_content, panel_footer, panel_color, panel_image_url y panel_thumbnail_url con un error 400. Edita su diseño en el panel de control.

Ejemplo de petición
curl -X PATCH \
  -H "Authorization: Bearer <API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"panel_title":"Contact Support","panel_color":"#57F287","button_text":"Get Help","button_color":"success"}' \
  https://api.ticketsx.xyz/<guild_id>/api/panels/<panel_id>
Ejemplo de respuesta
{
  "message": "Panel updated",
  "message_refreshed": true,
  "panel": {
    "PanelId": 1,
    "Type": "single",
    "PanelName": "Support",
    "PanelMessage": {
      "PanelTitle": "Contact Support",
      "PanelColor": "#57F287",
      "ButtonText": "Get Help",
      "ButtonColor": "success"
    }
  }
}