> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thenewscc.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Usar Resposta Rápida

> Incrementa o contador de uso e retorna o conteúdo formatado

## Descrição

Registra o uso de uma resposta rápida, incrementando o contador de utilizações, e retorna o conteúdo formatado para ser inserido na mensagem. Requer autenticação.

## Headers

<ParamField header="Authorization" type="string" required>
  Bearer token JWT para autenticação
</ParamField>

## Path Parameters

<ParamField path="quickReplyId" type="number" required>
  ID da resposta rápida
</ParamField>

## Response

<ResponseField name="success" type="boolean" required>
  Indica se a operação foi bem-sucedida
</ResponseField>

<ResponseField name="message" type="string">
  Mensagem descritiva
</ResponseField>

<ResponseField name="data" type="object">
  <Expandable title="Dados da resposta">
    <ResponseField name="conteudo" type="string">
      Conteúdo da resposta rápida para ser usado
    </ResponseField>

    <ResponseField name="usageCount" type="number">
      Contador de uso atualizado
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X POST "https://worker.thenewscc.com/support/quick-replies/15/usar" \
    -H "Authorization: Bearer seu_token_jwt"
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "message": "Resposta rapida utilizada com sucesso",
    "data": {
      "conteudo": "Olá! Lamentamos o problema com seu login. Por favor, tente limpar o cache do navegador e os cookies. Se o problema persistir, clique em 'Esqueci minha senha' para redefini-la.",
      "usageCount": 90
    }
  }
  ```

  ```json Error - Não Encontrada theme={null}
  {
    "success": false,
    "message": "Resposta rapida nao encontrada"
  }
  ```
</ResponseExample>

## Uso no Frontend

```typescript theme={null}
// Exemplo de uso com React
const handleUseQuickReply = async (quickReplyId: number) => {
  const response = await fetch(`/support/quick-replies/${quickReplyId}/usar`, {
    method: 'POST',
    headers: { Authorization: `Bearer ${token}` }
  });

  const data = await response.json();

  if (data.success) {
    // Inserir o conteúdo no campo de mensagem
    setMessageContent(data.data.conteudo);
  }
};
```