https://zowe-docs-master.netlify.app/assets/js/5959f002.d5841174.js

1"use strict";(self.webpackChunkdocs_site=self.webpackChunkdocs_site||[]).push([["15108"],{531940(e,t,s){s.r(t),s.d(t,{metadata:()=>a,default:()=>d,frontMatter:()=>i,contentTitle:()=>o,toc:()=>c,assets:()=>p});var a=JSON.parse('{"id":"user-guide/zowe-chat/chat_prerequisite_teams_create_app_developer_portal","title":"Creating Microsoft Teams bot app with Developer Portal","description":"To create a bot app for Microsoft\u2122 Teams, you need to use the tool Developer Portal to create a new app, specify app details, enable bot capabilities, and add it to your teams.","source":"@site/versioned_docs/version-v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams_create_app_developer_portal.md","sourceDirName":"user-guide/zowe-chat","slug":"/user-guide/zowe-chat/chat_prerequisite_teams_create_app_developer_portal","permalink":"/v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams_create_app_developer_portal","draft":false,"unlisted":false,"editUrl":"https://github.com/zowe/docs-site/edit/master/versioned_docs/version-v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams_create_app_developer_portal.md","tags":[],"version":"v3.3.x","lastUpdatedAt":1764001424000,"frontMatter":{},"sidebar":"setup","previous":{"title":"Configuring Microsoft Teams","permalink":"/v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams"},"next":{"title":"Creating a bot for Microsoft Teams bot app","permalink":"/v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams_create_bot"}}'),n=s(474848),r=s(28453);let i={},o="Creating Microsoft Teams bot app with Developer Portal",p={},c=[];function l(e){let t={a:"a",h1:"h1",header:"header",img:"img",li:"li",ol:"ol",p:"p",strong:"strong",ul:"ul",...(0,r.R)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(t.header,{children:(0,n.jsx)(t.h1,{id:"creating-microsoft-teams-bot-app-with-developer-portal",children:"Creating Microsoft Teams bot app with Developer Portal"})}),"\n",(0,n.jsx)(t.p,{children:"To create a bot app for Microsoft\u2122 Teams, you need to use the tool Developer Portal to create a new app, specify app details, enable bot capabilities, and add it to your teams."}),"\n",(0,n.jsx)(t.p,{children:"Developer Portal is a Teams app that makes it easy to create or integrate your own Microsoft Teams apps whether you develop custom apps for your enterprise or SaaS applications for teams around the world. It streamlines the creation of the manifest and package for your app and provides several useful tools like the Card Editor. You can find Developer Portal in the Teams store."}),"\n",(0,n.jsxs)(t.ol,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Find and add Developer Portal to your Microsoft Teams."}),"\n",(0,n.jsxs)(t.ol,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Launch and log in your Microsoft Teams client."}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Click the Apps icon at the bottom left of your Microsoft Teams window to open the Apps pane."}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Apps pane",src:s(838751).A+"",width:"844",height:"1822"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Search for Developer Portal with the search bar."}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Developer Portal",src:s(975886).A+"",width:"3556",height:"1910"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Select Developer Portal and click ",(0,n.jsx)(t.strong,{children:"Add"}),"."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Add Developer Portal",src:s(67162).A+"",width:"1800",height:"1448"})}),"\n",(0,n.jsx)(t.p,{children:"You can see the home page of Developer Portal."}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Create a new app."}),"\n",(0,n.jsxs)(t.ol,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click the ",(0,n.jsx)(t.strong,{children:"Apps"})," icon at the top of the home page of Developer Portal to open the Apps pane."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Apps pane",src:s(457201).A+"",width:"3582",height:"1806"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click the ",(0,n.jsx)(t.strong,{children:"New app"})," icon to create a new app."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Create a new app",src:s(960311).A+"",width:"3582",height:"1806"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["In the prompted dialog, specify a short name for your app that is used for c

1onfiguration in Zowe Chat as the bot username, and then click ",(0,n.jsx)(t.strong,{children:"Add"}),"."]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Specify the required values for your app, and then click ",(0,n.jsx)(t.strong,{children:"Save"}),"."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"New App pane",src:s(568103).A+"",width:"3582",height:"1806"})}),"\n",(0,n.jsxs)(t.ul,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["For ",(0,n.jsx)(t.strong,{children:"Descriptions"}),", specify a short description for your app."]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Specify all the required information accordingly."}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Developer information & App URLs",src:s(891949).A+"",width:"1186",height:"896"})}),"\n"]}),"\n"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Configure your app."}),"\n",(0,n.jsxs)(t.ol,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Switch to ",(0,n.jsx)(t.strong,{children:"Apps"})," pane and select the app that you created."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Your app",src:s(395755).A+"",width:"3556",height:"1822"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click the ",(0,n.jsx)(t.strong,{children:"App features"})," icon under ",(0,n.jsx)(t.strong,{children:"Configure"}),", and select ",(0,n.jsx)(t.strong,{children:"Bot"})," in App features pane."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"App features",src:s(271391).A+"",width:"3556",height:"1822"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Select the bot that you created in ",(0,n.jsx)(t.strong,{children:"Identify your bot"})," section."]}),"\n",(0,n.jsxs)(t.p,{children:["Select ",(0,n.jsx)(t.strong,{children:"Personal"}),", ",(0,n.jsx)(t.strong,{children:"Team"})," and ",(0,n.jsx)(t.strong,{children:"Group Chat"})," for ",(0,n.jsx)(t.strong,{children:"Scope"})," so that you can add the bot app to your teams. Save your settings and you can see your bot in the ",(0,n.jsx)(t.strong,{children:"Bots"})," panel."]}),"\n",(0,n.jsxs)(t.p,{children:[(0,n.jsx)(t.strong,{children:"Remember:"})," You need to create a bot if you don't have one. You can either create a bot with Microsoft Bot Framework or with Microsoft Azure. For specific steps, see ",(0,n.jsx)(t.a,{href:"/v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams_create_bot_framework",children:"Creating a bot with Microsoft Bot Framework"})," or ",(0,n.jsx)(t.a,{href:"/v3.3.x/user-guide/zowe-chat/chat_prerequisite_teams_create_bot_azure",children:"Creating a bot with Microsoft Azure"}),"."]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Publish your app."}),"\n",(0,n.jsxs)(t.ol,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click the ",(0,n.jsx)(t.strong,{children:"App package"})," icon under ",(0,n.jsx)(t.strong,{children:"Publish"}),"."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"App package",src:s(275915).A+"",width:"1782",height:"862"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click ",(0,n.jsx)(t.strong,{children:"Download app package"})," to download your app package."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Download your app package",src:s(927418).A+"",width:"1230",height:"246"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click the Apps icon at the bottom left of your Microsoft Teams window, and click ",(0,n.jsx)(t.strong,{children:"Manage your apps"}),"."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Manage your apps",src:s(715107).A+"",width:"419",height:"914"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Select ",(0,n.jsx)(t.strong,{children:"Upload a custom app"})," to add the app to a team. Upload the app package that you download in substep b."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Upload a custom app",src:s(552764).A+"",width:"661",height:"299"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Select ",(0,n.jsx)(t.strong,{children:"Add to a team"})," in the drill-down options."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Add to a team",src:s(206392).A+"",width:"273",height:"310"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Type or select a team to set up your bot."}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Set up a bot",src:s(597714).A+"",width:"1780",height:"1474"})}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsx)(t.p,{children:"Optional: You can also choose to publish your app to your organization's app catalog so that people in your organization can share it."}),"\n",(0,n.jsxs)(t.ol,{children:["\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Click the Apps icon at the bottom left of your Microsoft Teams window, and click ",(0,n.jsx)(t.strong,{children:"Manager your apps"}),"."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Manage your apps",src:s(715107).A+"",width:"419",height:"914"})}),"\n"]}),"\n",(0,n.jsxs)(t.li,{children:["\n",(0,n.jsxs)(t.p,{children:["Select ",(0,n.jsx)(t.strong,{children:"Submit an app to your org"})," to publish your app."]}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"Submit an app to your org",src:s(647852).A+"",width:"1228",height:"472"})}

1),"\n",(0,n.jsx)(t.p,{children:"Your app will appear on your Apps homepage when the IT admin of your organization approves."}),"\n",(0,n.jsx)(t.p,{children:(0,n.jsx)(t.img,{alt:"App catalog",src:s(525390).A+"",width:"1716",height:"710"})}),"\n",(0,n.jsx)(t.p,{children:"Now, people in your tenant can see this app and can use it."}),"\n"]}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsx)(t.p,{children:"You have successfully created a bot app for Microsoft Teams and can talk to it in your teams."})]})}function d(e={}){let{wrapper:t}={...(0,r.R)(),...e.components};return t?(0,n.jsx)(t,{...e,children:(0,n.jsx)(l,{...e})}):l(e)}},271391(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/app_features-bbe186398e5d7b0ce1ac22099cc08c56.png"},568103(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/new_app_panel2-62c1dd67fce1e2d2f67b6db5343db7b2.png"},206392(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_add_team-2a8ecd5cedce4c40c6312d339d855d79.png"},67162(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_app_add2-0deb961e50f9574d3385b9e71f515788.png"},525390(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_app_catalog-d801b1b3b5b23c2c137ec0eec0a375c1.png"},275915(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_app_package-7fd571cab728a113ad558aa4b719dc39.png"},457201(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_app_pane-2584dd9a56bf3a4a29766704b6e45138.png"},838751(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_app_panel2-c64a926dfbd4d6737aa8e7e12a4f113e.png"},395755(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_app_select-f197d6d2990047879d3150ac1b6079e9.png"},960311(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_create_app-7f7bedc428d40c80f26e4252b063e5e8.png"},975886(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_developer_protal-083d7a7c75b17745dcc7d729793367f3.png"},927418(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_download_app_package-647fd5faa05e97ee1eb7ac0858f97fc1.png"},891949(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_information-5574a62e97ceb69999de375dc34c0974.png"},715107(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_manage_your_apps-2b01898517e12ef0fb42cfe5034839b6.png"},597714(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_setup_bot-8215c183449b46520e068d08db859583.png"},647852(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_submit_org-bbd525ab1ad8709886f766ae157578bf.png"},552764(e,t,s){s.d(t,{A:()=>a});let a=s.p+"assets/images/teams_upload_custom_app-fc53b3161feca3876a10ad4960a55583.png"},28453(e,t,s){s.d(t,{R:()=>i,x:()=>o});var a=s(296540);let n={},r=a.createContext(n);function i(e){let t=a.useContext(r);return a.useMemo(function(){return"function"==typeof e?e(t):{...t,...e}},[t,e])}function o(e){let t;return t=e.disableParentContext?"function"==typeof e.components?e.components(n):e.components||n:i(e.components),a.createElement(r.Provider,{value:t},e.children)}}}]);