API atual/Referência completa/Venddor Intelligence: automações e canais

Loja pronta para agentes

Liga ou desliga a abertura da loja a assistentes de compra externos e mostra quantos pedidos vieram por esse canal.

Assistentes de IA de terceiros (aplicativos que compram em nome do usuário) podem consultar o catálogo e comprar numa loja que se declara pronta para agentes. Esse canal é uma opção da loja, desligada por padrão. Enquanto está desligado, o manifesto público da loja (/.well-known/mcp.json) e o ponto de acesso dos agentes respondem 404.

Ler

Devolve o estado do canal e dois contadores de pedidos vindos dele.

GET/api/v1/admin/intelligence/agent-commerce/settingsAdmin

Ler a loja pronta para agentes

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um administrador (veja Tokens).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/intelligence/agent-commerce/settings" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Estado do canal

json

{ "enabled": true, "orders_today": 2, "orders_total": 37 }

Campos da resposta

enabledboolean

Canal aberto.

orders_todayinteger

Pedidos do canal hoje.

orders_totalinteger

Pedidos do canal desde o início.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` ou `{"error":"invalid or expired token"}`
403	O administrador não tem nenhum dos privilégios exigidos.	`{"error":"insufficient privileges","privilege_required_any":["manage_settings","intelligence_use_chat"]}`

Ligar ou desligar

Liga ou desliga o canal. Os contadores do corpo são ignorados; a resposta já traz o estado atualizado.

PUT/api/v1/admin/intelligence/agent-commerce/settingsAdmin

Ligar ou desligar

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um administrador (veja Tokens).

Content-Typestringobrigatório

application/json.

Corpo da requisição

enabledbooleanobrigatório

true abre a loja a agentes de compra.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/intelligence/agent-commerce/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'

Resposta

200Canal atualizado

json

{ "enabled": true, "orders_today": 2, "orders_total": 37 }

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` ou `{"error":"invalid or expired token"}`
403	O administrador não tem nenhum dos privilégios exigidos.	`{"error":"insufficient privileges","privilege_required_any":["manage_settings","intelligence_use_chat"]}`
400	Corpo ilegível.	`{"error":"invalid request body"}`

Veja também

Configurações

Loja pronta para agentes

Liga ou desliga a abertura da loja a assistentes de compra externos e mostra quantos pedidos vieram por esse canal.

Ler

Devolve o estado do canal e dois contadores de pedidos vindos dele.

GET/api/v1/admin/intelligence/agent-commerce/settingsAdmin

Ler a loja pronta para agentes

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um administrador (veja Tokens).

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/admin/intelligence/agent-commerce/settings" \
  -H "Authorization: Bearer $TOKEN"

Resposta

200Estado do canal

json

{ "enabled": true, "orders_today": 2, "orders_total": 37 }

Campos da resposta

enabledboolean

Canal aberto.

orders_todayinteger

Pedidos do canal hoje.

orders_totalinteger

Pedidos do canal desde o início.

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` ou `{"error":"invalid or expired token"}`
403	O administrador não tem nenhum dos privilégios exigidos.	`{"error":"insufficient privileges","privilege_required_any":["manage_settings","intelligence_use_chat"]}`

Ligar ou desligar

Liga ou desliga o canal. Os contadores do corpo são ignorados; a resposta já traz o estado atualizado.

PUT/api/v1/admin/intelligence/agent-commerce/settingsAdmin

Ligar ou desligar

Cabeçalhos

Authorizationstringobrigatório

Bearer $TOKEN. Token de acesso de um administrador (veja Tokens).

Content-Typestringobrigatório

application/json.

Corpo da requisição

enabledbooleanobrigatório

true abre a loja a agentes de compra.

Exemplo de requisição

bash

curl -X PUT "$BASE_URL/api/v1/admin/intelligence/agent-commerce/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true
  }'

Resposta

200Canal atualizado

json

{ "enabled": true, "orders_today": 2, "orders_total": 37 }

Erros

Status	Quando	Corpo
401	Sem token ou token inválido/expirado.	`{"error":"missing authorization header"}` ou `{"error":"invalid or expired token"}`
403	O administrador não tem nenhum dos privilégios exigidos.	`{"error":"insufficient privileges","privilege_required_any":["manage_settings","intelligence_use_chat"]}`
400	Corpo ilegível.	`{"error":"invalid request body"}`

Veja também

Configurações