j1.1.4
API Overview
This REST API initializes an Agentforce session when a new session starts.
Authentication & Authorization
The Shopper Agent API requires a shopper access token from the Shopper Login and API Access Service (SLAS).
You must include the relevant scope(s) in the client ID used to generate the SLAS token.
sfcc.shopper-agents.rw: Required for initializing shopper agent session (POST operations).
For a full list of required permissions, see the Authorization Scopes Catalog.
For details on how to request a shopper access token from SLAS, see the guest user flows for public clients and private clients in the SLAS guides.
Use Cases
Shopper Agent Initialization
When a new agentic session starts, you receive a session initialization key. Include that key in the request to initialize the Agentforce session.
Flow:
- Obtain a
sessionInitKeyfrom a supported service. - Initialize an agent session using the previously obtained
sessionInitKey.
sessionInitKey
sessionInitKey is the session initialization identifier that is obtained when an Agentforce session starts.
The request body must include the sessionInitKey field. Missing or invalid sessionInitKey results in INVALID_REQUEST_PARAMETERS (400).
Let us know so we can improve!