Listar perguntas sugeridas
Devolve o conjunto de perguntas de exemplo ativas da loja para a tela inicial do assistente de IA.
Chame esta rota para obter o texto das perguntas que a tela inicial do assistente de IA oferece. A resposta é uma lista simples de textos, já na ordem em que a loja os configurou; cada texto pode ser enviado como está ao assistente, como se o administrador o tivesse digitado.
/api/v1/admin/suggested-promptsAdminLista as perguntas sugeridas ativas
Sem parâmetros e sem privilégio específico: basta um token de administrador. Só perguntas ativas entram, ordenadas pela ordem de exibição e, em caso de empate, pelo texto.
Exemplo de requisição
bash
curl "$BASE_URL/api/v1/admin/suggested-prompts" \
-H "Authorization: Bearer $TOKEN"Resposta
200Perguntas retornadas
json
{
"prompts": [
"Quais produtos vendem melhor?",
"Que categorias devo focar?",
"Como melhorar minhas descrições?",
"Quais pedidos estão pendentes?"
]
}Campos da resposta
promptsarrayTextos das perguntas ativas, em ordem. Pode ser
[]. Uma loja típica tem dezenas.Erros
| Status | Quando | Corpo de exemplo |
|---|---|---|
| 401 | Token ausente, inválido ou expirado. | {"error":"invalid or expired token"} |
| 403 | O token não é de administrador. | {"error":"insufficient permissions"} |
| 500 | Falha ao consultar as perguntas. | {"error":"failed to list suggested prompts","detail":"..."} |