Custom IDs

Setting Custom IDs in Tento Embedded Scripts

This document explains how to configure custom User and Business IDs from your partner system when using Tento embedded scripts.

Overview

When integrating Tento with your existing system, you can maintain references to your own user and business identifiers. The embedded script configuration allows you to set these custom IDs during initialization.

Configuration

Setting Custom IDs

window.Tento.configure({
  customUserId: 'your-system-user-id',      // Your system's unique user identifier
  customBusinessId: 'your-system-business-id', // Your system's unique business identifier
  // ... other configuration options
});

Configuration Options

  • customUserId: Your system's unique user identifier
  • customBusinessId: Your system's unique business identifier
  • partnerId: Your Tento partner identifier (required)

Best Practices

  1. Always ensure your custom IDs are unique within your system
  2. Use consistent ID formats across your integration
  3. Store these mappings in your system for future reference
  4. Consider using prefixes or namespaces to avoid potential conflicts

Validation

  • Custom IDs should be strings
  • Use URL-safe characters
  • IDs are case-sensitive