Embedding the Worker Portal

Overview

This guide outlines the steps to embed the Worker Portal into your native app using an authenticated URL generated by your backend.

Steps

Generate an Authenticated URL: Use the following API endpoint to get an authenticated URL: Fountain API: Worker Impersonation.

Custom Redirect: To redirect the worker to a specific page (e.g., a task flow), append the desired path at the end of the URL: &next=/task-flow/{FLOW_UUID}

Embedding in the App: Embed the generated URL as an iframe within your native app.

Limitations

Session Expiration: The authenticated URL is valid for 60 minutes. After expiration, the worker will be prompted to re-authenticate via an email verification link, which opens outside of the native app.

Email Triggers: Any email-based notifications, such as reminders, will direct workers to log into the portal outside the app where it is embedded.