<aside> 📌 Herald helps product and customer teams work together to paint a full picture of user problems. 🙌
</aside>
<aside>
🔑 This question is part of Herald: Frequently Asked Questions. Have a question that's not answered there? Our bad, give us a chance to answer your question: we're only an e-mail away: [email protected]
.
</aside>
There are two ways to integrate your public portal with your app.
From "Settings >> Workspace", create a Herald API key:
Herald's Public Portal requires a secure token to identify the user. This token is based on the JSON Web Token (JWT) standard, and be generated by your backend with only a few lines of code. There are open source JWT libraries for most languages.
Here is sample code in selected languages (let us know if you need it for another language):
Note: for sake of security, Herald will reject all JWTs with an expiration longer than 30 days, so please set expiration to less than that.
Present a link to your customer of the format: https://[slug].herald.fyi/[slug]?token=[token]
, where slug
is your Herald workspace slug and token
is the user token generated by step 2 above.
You may also redirect the user to specific component of the Herald Public Portal:
https://[slug].herald.fyi/[slug]/roadmap?token=[token]
https://[slug].herald.fyi/[slug]/changelog?token=[token]