{"id":2900,"date":"2019-05-10T20:13:23","date_gmt":"2019-05-11T03:13:23","guid":{"rendered":"https:\/\/developer.microsoft.com\/en-us\/office\/blogs\/?p=2900"},"modified":"2019-05-10T20:13:23","modified_gmt":"2019-05-11T03:13:23","slug":"messaging-extensions-available-on-mobile-devices-for-microsoft-teams","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/messaging-extensions-available-on-mobile-devices-for-microsoft-teams\/","title":{"rendered":"Messaging Extensions available on mobile devices for Microsoft Teams"},"content":{"rendered":"<p>We&#8217;re excited to announce that beginning soon\u00a0<a href=\"https:\/\/docs.microsoft.com\/en-us\/microsoftteams\/platform\/concepts\/messaging-extensions\/messaging-extensions-overview\">messaging extensions<\/a> will be available on Microsoft Teams for iOS and Android. Messaging extensions allow you to initiate your app from the compose message box (where you type in your message), and come in two general types. <a href=\"https:\/\/docs.microsoft.com\/en-us\/microsoftteams\/platform\/concepts\/messaging-extensions\/search-extensions\">Search-based messaging extensions<\/a> allow searching for something in an external system or service, and insert the results into a message. <a href=\"https:\/\/docs.microsoft.com\/en-us\/microsoftteams\/platform\/concepts\/messaging-extensions\/create-extensions\">Action-based messaging extensions<\/a> guide the user through some action, typically by presenting them with a form and sending the information collected to an external system.<\/p>\n<h2>Preparing for the change<\/h2>\n<p>If you have a Microsoft Teams app with a messaging extension, you&#8217;ll want to check a couple of things to ensure your app functions smoothly for your mobile users.<\/p>\n<ul>\n<li><strong>If your messaging extension requires authentication<\/strong><strong>:\u00a0<\/strong>You&#8217;ll want to upgrade your <a href=\"https:\/\/www.npmjs.com\/package\/@microsoft\/teams-js\">Teams JavaScript SDK<\/a> to version 1.4.1 or later.<\/li>\n<li><strong>If your messaging extension has a configuration\/setup page:\u00a0<\/strong>Make sure that your configuration page renders well on a mobile-size screen. At a minimum you&#8217;ll want to verify that your screen is functional; ideally your page responds well to mobile and formats itself to meet expected mobile norms.<\/li>\n<\/ul>\n<h2>Search-based Messaging Extension Example<\/h2>\n<p>First, click the &#8220;&#8230;&#8221; button on the compose message box to bring up the list of available messaging extensions.<\/p>\n<p><img decoding=\"async\" class=\"alignnone wp-image-2905 size-medium\" style=\"border: 1px solid black\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-1-169x300.png\" alt=\"open messaging extension\" width=\"169\" height=\"300\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-1-169x300.png 169w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-1.png 545w\" sizes=\"(max-width: 169px) 100vw, 169px\" \/><\/p>\n<p>Next, enter your search term and select the item you want to insert<\/p>\n<p><img decoding=\"async\" class=\"alignnone wp-image-2904 size-medium\" style=\"border: 1px solid black\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-2-169x300.png\" alt=\"search messaging extension\" width=\"169\" height=\"300\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-2-169x300.png 169w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-2.png 552w\" sizes=\"(max-width: 169px) 100vw, 169px\" \/><\/p>\n<p>Finally, complete your message and insert it into the chat\/channel.<\/p>\n<p><img decoding=\"async\" class=\"alignnone wp-image-2903 size-medium\" style=\"border: 1px solid black\" src=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-3-169x300.png\" alt=\"messaging extension response\" width=\"169\" height=\"300\" srcset=\"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-3-169x300.png 169w, https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-content\/uploads\/sites\/73\/2019\/05\/messaging-extension-mobile-3.png 554w\" sizes=\"(max-width: 169px) 100vw, 169px\" \/><\/p>\n<h3>Known Issues<\/h3>\n<ul>\n<li>If you run into any issues with authentication, update your <a href=\"https:\/\/www.npmjs.com\/package\/@microsoft\/teams-js\">Teams JavaScript SDK<\/a>.<\/li>\n<li>If your messaging extension has more than one query command, only the first will be enabled.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Beginning on May 10th custom messaging extensions will be available on Microsoft Teams for iOS and Android.<\/p>\n","protected":false},"author":69074,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[128],"tags":[],"class_list":["post-2900","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-teams"],"acf":[],"blog_post_summary":"<p>Beginning on May 10th custom messaging extensions will be available on Microsoft Teams for iOS and Android.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/2900","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69074"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=2900"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/2900\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=2900"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=2900"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=2900"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}