Deeplinking to a Welcome Message

Every Welcome Message can be deeplinked to. When a user follows the deeplink, the Direct Message compose view will be opened with the specified Welcome Message presented. Deeplinks can be used anywhere from a website, an app, a Tweet or even another Direct Message conversation.

To create a Welcome Message deeplink:

  1. Create a new Welcome Message with POST direct_messages/welcome_messages/new. Take note of the returned Welcome Message ID.
  2. Construct a Direct Message deeplink with the recipient_id and welcome_message_id query string parameters defined.

Example Direct Message Deeplink:

https://twitter.com/messages/compose?recipient_id= 3805104374&welcome_message_id=12345

Note: You can create as many Welcome Messages as you require and all Welcome Messages can be deeplinked to.

Deeplinking from a Tweet 

By simply including the Direct Message deeplink URL at the end of a Tweet, your can append a "Send a private message" button to the bottom of the Tweet. Read more about using Direct Message deeplinks in Tweets in this blog post.

Using a Direct Message Card, businesses can capture people’s attention with engaging image or video creatives, and include up to four fully customizable call-to-action buttons. Each call-to-action button can deeplink to a unique Welcome Message. The Direct Message Card is currently available in limited beta to Twitter advertisers. Contact your Twitter representative for more information.

Deeplinking from a Website

Direct Message deeplinks may also be used to deeplink from a website or other external source like a mobile app. For more details on deeplinking to Welcome Messages from a website, see Message Button documentation.

Was this document helpful?

Thank you

Thank you for the feedback. We’re really glad we could help!

Thank you for the feedback. How could we improve this document?

Thank you for the feedback. Your comments will help us improve our documents in the future.