How to create a link to the webapp for a view of a draft (or message)

Hi Guillaume,

When you create a draft through the API, there should be a URL provided in the response body under response._links.self that contains the URL which should open this exact draft. You can provide this URL to your teammates and they should be able to then click it to open Front and edit the draft from there.

No, this is not the correct answer. The url is of the format https://louve.api.frontapp.com/messages/msg_24dyrgsy As you can see it is a url to the api not to the webapp. All the url in the _links property are property to the api.

>    _links: {
>      self: 'https://louve.api.frontapp.com/messages/msg_24dyrgsy',
>      related: {
>        conversation: 'https://louve.api.frontapp.com/conversations/cnv_16pf52du',
>        message_seen: 'https://louve.api.frontapp.com/messages/msg_24dyrgsy/seen'
>      }
>    }

Hi Guillaume,

My apologies - I had forgotten that we append the ‘.api’ part to the URL. If you remove that portion then the URL should be formatted in a way that teammates can click it to take them to the message. One thing to be aware of - the ‘mode’ field needs to be set to ‘shared’ such that teammates can access the draft. The response._links.self URL should then take you to the message provided that you remove the ‘api’ string.

Hi, I tried removing the `.api` part of the url and it still doesn’t work. It just redirect me to whatever last draft in my inbox there is, not the specific draft I want to display.

I fear the link to the fontapp is not in the `_links` property. Where can I create a link to the webapp to display a specific draft or message ?

Hi, Guillaume 👋
 

The URLs in _links are URLs that are only useful for the API; they should not be used (either directly or by manipulating the URL) to redirect the user to the app. Our apologies for any prior confusion on the viability of this path.

That being said, our documentation explains how to open Front with a message ID or a conversation ID.

Best, 
Justin 

Thanks for the update, Guillaume. 

For a message in a draft state, we would recommend using the conversation ID method, as you’ve confirmed. The message ID url to open is operational for messages that are not in a draft state. 

As a result, we’ve added a note to our documentation of this to help clarify for our users. 

Best, 
Justin 

It’s great you’ve updated the documentation, but :

• you should update this documentation too: https://dev.frontapp.com/reference/conversations#opening-a-conversation-in-front
• you should put the conversation id in the response of the create draft endpoint (and other endpoint like create message) directly. I had to extract it out of the url `_links.related.conversation`. It would have been better to extract it out of the path `conversation.id`

Thanks, Guillaume. 

Happy to provide the feedback and request to our Product teams. 

Best,
Justin