VenddorDocumentação API
API atualAPI legada
Guia rápidoReferência completa
Carregando índice…
API atual/Referência completa

Perguntas sugeridas

O que são as perguntas sugeridas da tela inicial do assistente de IA do painel e como lê-las pela API.

Quando o administrador abre o assistente de IA do painel da loja, a tela inicial mostra algumas perguntas sugeridas ("Quais produtos vendem melhor?", "Quais pedidos estão pendentes?") para ele clicar em vez de digitar. A loja guarda um conjunto dessas perguntas, e a tela sorteia algumas delas a cada visita. Esta seção tem uma única rota, que devolve o conjunto inteiro para você montar a sua própria tela, um atalho de teclado ou uma lista de exemplos num chatbot interno.

Pontos-chave
  • Qualquer administrador logado pode ler; não há privilégio específico.
  • A rota devolve todo o conjunto ativo, não um sorteio. Sortear algumas perguntas é com o cliente.
  • As perguntas vêm em ordem fixa (a ordem configurada na loja) e no idioma em que foram cadastradas, em geral português.
  • Esta seção é somente leitura: a API não cadastra nem altera perguntas.

Endpoints

MétodoCaminhoPara que serveAuth
GET/api/v1/admin/suggested-promptsListar perguntas sugeridasadmin

Erros comuns

  • Esperar que a lista mude a cada chamada. Ela é estável; o sorteio é feito pela tela.
  • Tratar a lista vazia como erro. Uma loja sem perguntas ativas recebe "prompts": [] com status 200.
  • Chamar com um token de cliente ou de seller. A rota é só do painel do administrador e responde 403 a outros perfis.

Próximos passos

Listar perguntas sugeridas
Exemplo completo da chamada e da resposta.
Anterior
Importação de produtos por IA
Próxima
Listar perguntas sugeridas
Nesta página
  • Endpoints
  • Erros comuns
  • Próximos passos