Skip to main content

Documentation Index

Fetch the complete documentation index at: https://documentation.uponai.com/llms.txt

Use this file to discover all available pages before exploring further.

Public keys are designed for authenticating the UponAI Chat Widget when embedded on your website. Unlike API keys, public keys are safe to include in frontend code for this specific purpose. Public keys are used exclusively for:
  • Embedding the UponAI Chat Widget on your website

​
Allowed Domains

For security, public keys are restricted to specific domains — preventing unauthorized use on other websites.
1

Navigate to Public Keys

Go to Public Keys in your UponAI dashboard.
2

Select your key

Click on the public key you want to configure.
3

Add allowed domains

Add the domains where this public key can be used (e.g., example.com, app.example.com).
4

Save

Save your changes.
To test locally, add localhost to your allowed domains list.

​
Google reCAPTCHA v3 Protection (Optional)

Enable reCAPTCHA v3 to prevent abuse when using the chat widget. When enabled, the widget requires reCAPTCHA verification before initiating conversations.
1

Navigate to Public Keys

Go to Public Keys in your dashboard and click the key to configure.
2

Enable abuse prevention

Toggle on Abuse Prevention (Google reCAPTCHA).
3

Add your reCAPTCHA Secret Key

Enter your reCAPTCHA Secret Key (obtain from Google’s reCAPTCHA page).
4

Set score threshold

Adjust the Score Threshold (default: 0.5). Lower scores are more likely bots — a higher threshold may block more real users.
5

Save and implement frontend

Save your changes, then implement reCAPTCHA on your frontend. See Google’s reCAPTCHA documentation for implementation details.

​
Security Best Practices

  • Only add domains you control to the allowed domains list
  • Review your allowed domains regularly
  • Use the most restrictive domain settings possible for your use case
  • For server-to-server communication, use API keys instead

​
Managing Public Keys

Navigate to Public Keys in your dashboard to create, view, and configure public keys. Copy the public key to use with the chat widget on your website.