User and Session Identification - Cognigy Documentation

Restrictions

• You must use session IDs only within one organization in your Cognigy.AI installation.
• Except for the Voice Copilot Endpoint, reusing the combination of user and session IDs across Endpoints causes Endpoint collisions and unexpected behavior.
• You must keep user and session IDs unchanged during interactions with AI Agents. Changing user and session IDs with transformers, xApps, Extensions, or Code Nodes can cause unexpected issues and terminate interactions with AI Agents.

User ID

User ID is a unique identifier assigned to each user that helps manage user data safely, personalize user experiences, and keep track of user history and preferences. The AI Agent uses this information to improve its responses and customize the conversation according to the user’s needs. The user ID can be hashed in transformers to enhance privacy and support GDPR compliance.

Session ID

Session ID is a unique identifier given to each session initiated by a user. A session represents a period of interaction between the user and the AI Agent. The AI Agent uses session IDs to manage user sessions, track user activity, ensure security, and provide personalized experiences within the conversation.

Get User and Session IDs

To get the user ID and session ID, you can:

• Retrieve them from the Input object by using the input.userId and input.sessionId CognigyScript expressions, or the User ID and Session ID Tokens.
• Copy them from the Logs page.

More Information

• Input
• Logs
• xApps

Last modified on April 21, 2026