How to get an integration hub up and running in a React application in minutes.
2.x.x
+ of the @versori/embed-react
package is installed, as this is the version
that supports the platform API.VersoriEmbeddedProvider
component in your application, and pass in some configuration:
token
in the above example is a JWT with the subject claim set to the externalId
of the End User. The VersoriEmbeddedProvider
then knows which environments the End User is activated on, and will display the relevant integrations in the UI. You can see the Security section for more information on how to generate this token.
This example is the most minimal setup required to get started. The VersoriEmbeddedProvider
component configures an
EmbedClient
instance and exposes it over a React context. The VersoriEmbeddedRenderer
component is a pre-built
component which renders the integration hub UI in your application, handling displaying the correct UI elements based on
whether the End User has the integrations activated.
Given the above, the VersoriEmbeddedRenderer
is optional, and you can build your own UI components consuming the
EmbedClient
context directly if this suits your application better.
For more information on using the SDK, the source code is available in the versori/versori-js-sdk
repository.
This repository also contains an example React application with the SDK along with an example client website that uses Cookies to store the JWT token so that it is persisted across page reloads and redirects to the Embedded Integration Hub.