# Criar ou atualizar resposta rápida

`POST /quickreply/edit`

Pasta: **Respostas Rápidas**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Criar ou atualizar resposta rápida

Salva (upsert) um template de resposta rápida no banco da instância. Sem `id`, a API gera um novo; com `id` existente, atualiza o registro.

## Endpoint

`POST {{baseUrl}}/quickreply/edit`

## Autenticação

Envie o token da instância no header `token: {{token}}`.

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| `shortCut` | string | Sim* | Atalho do template (*not null no modelo). |
| `text` | string | Sim* | Texto da resposta (*not null no modelo). |
| `type` | string | Não | Tipo do template (`text`, `image`, `document`, `video`, `audio`, etc.). |
| `file` | string | Não | URL do arquivo/mídia, quando aplicável. |
| `docName` | string | Não | Nome do documento. |
| `id` | string | Não | ID do template; omita para criar. |
| `onWhatsApp` | boolean | Não | Indica origem no WhatsApp; padrão `false`. |
| `owner` | string | Não | Dono opcional do registro. |

## Exemplo de Requisição

```bash
curl --request POST '{{baseUrl}}/quickreply/edit' \
  --header 'token: {{token}}' \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "shortCut": "saudacao",
  "type": "text",
  "text": "Olá! Como posso ajudar hoje?"
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "quickreply": {
    "id": "rb9da9c03637452",
    "client_name": "gozap",
    "created": "2026-07-17T12:00:00Z",
    "updated": "2026-07-17T12:00:00Z",
    "onWhatsApp": false,
    "docName": "",
    "file": "",
    "shortCut": "saudacao",
    "text": "Olá! Como posso ajudar hoje?",
    "type": "text",
    "owner": ""
  }
}
```

## Erros comuns

- `400 Bad Request`: JSON inválido.
- `500 Internal Server Error`: falha ao salvar no banco.
- `401 Unauthorized`: token inválido.

## Observações

- O handler atual faz apenas upsert; não há campo `delete` nesta rota.
- Liste templates em `GET /quickreply/showall` para obter o `id` na edição.

## Corpo (exemplo)

```json
{
  "shortCut": "saudacao",
  "type": "text",
  "text": "Olá! Como posso ajudar hoje?"
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/quickreply/edit" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "shortCut": "saudacao",
  "type": "text",
  "text": "Olá! Como posso ajudar hoje?"
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=respostas-rapidas/criar-ou-atualizar-resposta-rapida)