Redirect or embed

With a Hosted Pages URL, you can choose to either embed Hosted Pages into your app or redirect your stakeholders to a new page.

Both approaches offer identical functionalities and features. Nonetheless, embedding Hosted Pages typically results in a more seamless and enhanced user experience for your stakeholders.

Set up

Redirect

You can use the URL to Hosted Pages to redirect your stakeholder in a few ways, for example, using an <a> tag:

01

Embed

You can easily embed the URL content of Hosted Pages through an iframe.

01

Upon activity completion

Once a stakeholder completes all their activities, you'll typically want them to see a success screen, and then be redirected to a certain page in a web app, or to a specific screen in a native app.

How to

When you are using sessions to generate Hosted Pages URL, you can pass the success_url upon creating the session. When a stakeholder completes all activities, we'll make sure to send the patient to the specified URL.

If you are using Hosted Pages Links, the success_url can be configured in Awell Studio.

Default behaviour

If no success_url is specified, the stakeholder will see a default completion screen which prompts them that they can safely close the page as they have completed all their activities.

With embed

When integrating Hosted Pages in an iframe or a WebView for native apps, setting a success URL will redirect the iframe or WebView to the specified URL. However, you may also want to trigger an action in the main application or view. To achieve this, you can listen for URL changes within the iframe or WebView.

Here's the process:

1. Configure the success_url to trigger a URL change
2. Detect this URL change and then execute your desired navigation or action in response.