---
title: Widget Customizável
slug: aura/widget-customizavel
docTags: 
createdAt: 2025-07-07T20:39:55.891Z
---

A plataforma permite que desenvolvedores criem **widgets personalizados**, com total liberdade para escrever código.

## Customizando

É possível alterar a configuração padrão do widget utilizando a ferramenta de edição de código, permitindo ao desenvolvedor personalizar diretamente o CSS do widget.



## Configuração de um Widget

***

### Registro

**Endpoint:**
`POST /widgets/save/{name}`

:::BlockQuote
**Observações:**

- O registro é obrigatório para utilizar qualquer funcionalidade.
- O registro deve ser feito utilizando o **LowCode** ou a **CLI Aura**.
:::

***

### Enviar Arquivo

**Endpoint:**
`POST /send-file/{widget_name}/{session_id}`

**Parâmetros:**

- `widget_name`: Nome do widget registrado.
- `session_id`: ID da sessão ativa.

***

### Enviar Mensagem

**Endpoint (WebSocket):**
`/ws/{widget_name}/{session_id}`

**Parâmetros:**

- `widget_name`: Nome do widget registrado.
- `session_id`: ID da sessão ativa.

***

### Histórico de Mensagens

**Endpoint:**
`GET /history/{widget_name}/{session_id}`

**Parâmetros:**

- `widget_name`: Nome do widget registrado.
- `session_id`: ID da sessão ativa.

***

### Download de Anexos

**Endpoint:**
`GET /widgets/{widget_name}/download/{ano}/{mes}/{dia}/{numero}.{ext}`

**Parâmetros:**

- `widget_name`: Nome do widget registrado.
- `ano`, `mes`, `dia`: Data do envio.
- `numero`: Identificador do anexo.
- `ext`: Extensão do arquivo (ex: `.pdf`, `.png`).

***

### Pré-visualização de Mensagens

**Endpoint de referência:**
`/receive-message`

:::BlockQuote
**Observações:**
Toda resposta enviada do sistema segue o formato da mensagem do tipo `ReceiveMessageFromEngine`, exibindo uma **prévia (preview)** do conteúdo.
:::

***