Identify your users
To effectively manage your contacts, we advise usingGleap.getInstance().identifyContact() each time a user signs in or registers. This practice ensures accurate identification of your contacts from the outset. Additionally, for scenarios where contact information needs to be updated during active usage – such as when a user subscribes to a new plan or modifies their existing data – we recommend utilizing Gleap.getInstance().updateContact(). This method allows for seamless real-time updates to contact details.
Identify your user by calling the following method.
When transmitting custom data, only primitive numeric and string values are supported for later use in segment filters.
Please note that you can send only 35 custom data keys with an identify call.We currently only allow JSON strings, numbers and boolean values as custom data.
Gleap defaults to guest sessions when feedback items get reported without
calling the identify method first. All feedback items of an existing guest
session are merged with the user session once you’ve identified it.
Enforce identity verification
Enforce identity verification to prevent third parties from impersonating logged-in users. Learn how to generate the user hashProtected conversation files
With Require authenticated file access (Authenticated conversation files), conversation files can only be opened by agents and by the verified customer the conversation belongs to. The SDK (19.0.0 or newer) supports it without extra setup, as long as your app identifies the customer with the user hash (see above) on every app start. A verified identify gets a short-lived file session (15 minutes). The SDK keeps it in memory only (never on disk), passes it to the widget and renews it automatically before it expires.clearIdentity revokes it.
Email replies link attachments to your customer application URL with a gleapFile query parameter. If your app handles that URL (for example as an App Link), pass the URL that opened the app to Gleap; once the user is identified, the SDK opens the file’s conversation if the user may see it:
openProtectedFileFromUrl takes the URL as a String and returns false when it has no valid gleapFile parameter. Keep the parameter through your app’s login flow.
Update contact properties
To effectively manage your contacts, we advise usingGleap.getInstance().identifyContact() each time a user signs in or registers. This practice ensures accurate identification of your contacts from the outset. Additionally, for scenarios where contact information needs to be updated during active usage – such as when a user subscribes to a new plan or modifies their existing data – we recommend utilizing Gleap.getInstance().updateContact(). This method allows for seamless real-time updates to contact details.