13.11
Actualizar un panel
/<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)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| panel_title | string|null | opcional | Título del embed (256 caracteres máx.). Envía null para vaciarlo. |
| panel_description | string|null | opcional | Descripción del embed (4096 caracteres máx.). Envía null para vaciarla. |
| panel_content | string|null | opcional | Texto plano encima del embed (2000 caracteres máx.). Envía null para vaciarlo. |
| panel_footer | string|null | opcional | Texto del pie del embed (2048 caracteres máx.). Envía null para vaciarlo. |
| panel_color | string|null | opcional | Color del embed en hexadecimal, por ejemplo #5865F2. Envía null para vaciarlo. |
| panel_image_url | string|null | opcional | Imagen del embed como URL http(s). Envía null para vaciarla. |
| panel_thumbnail_url | string|null | opcional | Miniatura del embed como URL http(s). Envía null para vaciarla. |
| panel_name | string | opcional | Nombre del panel que se usa para nombrar los tickets (100 caracteres máx.). Solo en paneles simples. |
| button_text | string|null | opcional | Etiqueta del botón (80 caracteres máx.). Solo en paneles simples. |
| button_color | string | opcional | Estilo del botón: primary, secondary, success o danger. Solo en paneles simples. |
| button_emoji | string|null | opcional | Emoji del botón (unicode o ID de emoji personalizado). Solo en paneles simples. |
| disabled | boolean | opcional | Desactiva o reactiva el panel. Solo en paneles simples. |
| bypass_auto_close | boolean | opcional | Deja los tickets de este panel fuera del cierre automático, aunque esté activado para el servidor. Solo en paneles simples. |
| dropdown_placeholder | string|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.
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>{
"message": "Panel updated",
"message_refreshed": true,
"panel": {
"PanelId": 1,
"Type": "single",
"PanelName": "Support",
"PanelMessage": {
"PanelTitle": "Contact Support",
"PanelColor": "#57F287",
"ButtonText": "Get Help",
"ButtonColor": "success"
}
}
}