Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.argide.ai/llms.txt

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

Identity verification lets your agent know who the user is — enabling personalized support and persistent conversations.

​
What You Get

FeatureAnonymousVerified
ChatYesYes
Conversation historyNoYes
Personalized by nameNoYes
User-specific actionsNoYes

​
How It Works

  1. User logs into your app
  2. Your backend mints an Argide identity token (JWT signed with your Argide secret)
  3. Your frontend calls window.argide('identify', { token })
  4. Widget now knows who the user is
This is not your app’s session JWT. It’s a separate Argide-scoped identity token that your backend mints specifically for Argide. Your app JWT stays private.

​
1. Get Your Secret

Go to dashboard.argide.ai/dashboard/deploy/widget → copy Verification Secret. Add to your backend environment: 
ARGIDE_VERIFICATION_SECRET=your_secret_here
Never expose this secret in frontend code.

​
2. Create Backend Endpoint

const jwt = require('jsonwebtoken');

app.get('/api/argide-token', authMiddleware, (req, res) => {
  const token = jwt.sign(
    {
      user_id: String(req.user.id),
      exp: Math.floor(Date.now() / 1000) + 3600,
      email: req.user.email,
      name: req.user.name,
    },
    process.env.ARGIDE_VERIFICATION_SECRET,
    { algorithm: 'HS256' }
  );
  res.json({ token });
});

​
JWT Payload

FieldTypeRequiredDescription
user_idstringYesUnique user identifier
expnumberYesExpiration (Unix timestamp)
emailstringNoUser’s email
namestringNoDisplay name

​
3. Identify in Frontend

import { ArgideWidget } from "@argide/ui";

function App() {
  return (
    <ArgideWidget
      productId="YOUR_PRODUCT_ID"
      apiUrl="https://dashboard.argide.ai"
      getIdentityToken={async () => {
        const res = await fetch('/api/argide-token');
        const { token } = await res.json();
        return token;
      }}
    />
  );
}
With the React SDK, pass getIdentityToken to the widget component. The SDK calls it on mount and auto-refreshes when the token expires — no manual polling needed.
That’s it. No useEffect, no setInterval, no window.argide('identify') calls.

​
4. Handle Logout

// Logout is handled automatically — when the component unmounts
// or the user navigates away, the session is cleared.

​
Troubleshooting

IssueSolution
User not identifiedCheck secret matches dashboard, user_id is a string
Token invalidCheck exp is in the future, algorithm is HS256
History not persistingCall identify() on page load, not just after login