Linking back to your app

For example, if you made an inbox page on https://yoursite.com/inbox, we recommend that you give this page an optional parameter that preselects the appropriate conversation, e.g. https://yoursite.com/inbox?conversation=123456. Then, in the email settings on the dashboard, use template macros to make TalkJS build the appropriate link: https://yoursite.com/inbox?conversation={{conversation.id}}.

You may prefer to send the user back to the page where they started the conversation. For example, if they were discussing a particular product or order, you might want to make the Inbox URL not lead back to an inbox page at all, but straight to the page about that product or order, and embed a Chatbox or Popup there. In this case, you will want to build a link that contains the appropriate product or order ID.

If you used the order ID for a conversation ID then you can use a similar URL as above: https://yoursite.com/orders/{{conversation.id}}. If a conversation ID is different from the relevant order or product ID, then you may wish to add a custom field to the conversation.

For example, you could pass {"productId": "12345"} when creating the conversation and then configure the Inbox URL like this: https://yoursite.com/orders/{{conversation.custom.productId}}

If you want to make it as easy as possible for a user to log back into your site, even on different devices, you may wish to add an authentication token to the Inbox URL which automatically logs your user in.

A practical way to do this is to give the user a custom field called authToken which contains a cryptographically signed token (for example, a JSON Web Token) containing the user's ID and an expiry date. Set up the Inbox URL like this: https://yoursite.com/inbox?conversation={{conversation.id}}&authToken={{user.custom.authToken}}

Then, in the backend on your inbox page, check whether a valid authToken was passed. If so, log the user in before displaying the page.