Robot csatlakoztatása a Slackhez
A KÖVETKEZŐKRE VONATKOZIK: SDK v4
A robotot konfigurálhatja úgy, hogy egy Slack-alkalmazáson keresztül kommunikáljon az emberekkel. Ez a cikk bemutatja, hogyan hozhat létre Slack-alkalmazást a Slack használatával, hogyan csatlakoztathatja a robotot az Azure-beli Slack-alkalmazáshoz, és hogyan tesztelheti a robotot a Slackben.
Ez a cikk bemutatja, hogyan adhat hozzá Slack-csatornát a robothoz az Azure Portalon. Az egyéni csatornaadapter használatáról további információt a További információk című témakörben talál.
Előfeltételek
- Azure-előfizetés. Ha még nem rendelkezik ilyen fiókkal, a kezdés előtt hozzon létre egy ingyenes fiókot .
- Az Azure-ban közzétett robot, amelyhez csatlakozni szeretne a Slackhez.
- Hozzáférés a Slack-munkaterülethez megfelelő engedélyekkel az alkalmazások létrehozásához és kezeléséhez a címen https://api.slack.com/apps. Ha nem fér hozzá a Slack-környezethez, létrehozhat egy munkaterületet.
Alkalmazás létrehozása a Slackben
Először létre kell hoznia egy alkalmazást a Slackben, amely létrehozza azokat az információkat, amelyekre szüksége van ahhoz, hogy konfigurálja a Slack-csatornát a robothoz az Azure-ban.
- Lépjen az Alkalmazások panelre, és jelentkezzen be a Slack-fiókjába.
- Válassza az Új alkalmazás létrehozása vagy Az alkalmazás létrehozása lehetőséget, ha ez az első alkalmazás.
- Az Alkalmazás létrehozása lapon válassza az Alapoktól lehetőséget.
- A Név alkalmazás > munkaterület kiválasztása lapon adja meg a Slack-alkalmazás nevét az Alkalmazásnév mezőben.
- Ha kiválaszt egy munkaterületet az alkalmazás fejlesztéséhez, válasszon egy munkaterületet az alkalmazáshoz.
- Tekintse át és fogadja el a Slack API szolgáltatási feltételeit.
- Válassza az Alkalmazás létrehozása lehetőséget.
Új átirányítási URL-cím hozzáadása
Az alkalmazás létrehozása után adjon hozzá egy átirányítási URL-címet az alkalmazáshoz.
Válassza az OAuth > Engedélyek lehetőséget.
Az eredményként kapott panel Átirányítási URL-címek csoportjában válassza az Új átirányítási URL-cím hozzáadása lehetőséget.
A beviteli mezőbe írja be az alábbi átirányítási URL-címek egyikét, és válassza a Hozzáadás lehetőséget.
- Globális robot esetén írja be a következőt
https://slack.botframework.com: - Regionális robot esetén adja meg a következő URL-címet a kiválasztott régió szerint:
Régió Átirányítási URL-cím Európa https://europe.slack.botframework.com India https://india.slack.botframework.com - Globális robot esetén írja be a következőt
Válassza az URL-címek mentése lehetőséget.
Feliratkozás a roboteseményekre
Miután hozzáadta az átirányítási URL-címet, iratkozzon fel az alkalmazásra a roboteseményekre, hogy a Slack értesítse a robotot a felhasználói tevékenységekről a megadott URL-címen. Iratkozzon fel az eseményekre a robot által a Slackben használni kívánt funkciók alapján.
Válassza az Esemény-előfizetések lehetőséget.
Az eredményként kapott panelen kapcsolja be az Események engedélyezése lehetőséget.
A kérelem URL-címéhez adja meg a következő kérés URL-címeinek egyikét, ahol
{bot-name}az Azure Bot-erőforrás megjelenítendő neve szerepel a zárójelek nélkül.- Globális robot esetén írja be a következőt
https://slack.botframework.com/api/Events/{bot-name}: - Regionális robot esetén adja meg a következő URL-címet a kiválasztott régió szerint:
Régió URL-cím kérése Európa https://europe.slack.botframework.com/api/Events/{bot-name}India https://india.slack.botframework.com/api/Events/{bot-name}- Globális robot esetén írja be a következőt
A Feliratkozás roboteseményre területen válassza a Robotfelhasználói esemény hozzáadása lehetőséget, majd iratkozzon fel az eseményekre. Példa:
member_joined_channelmember_left_channelmessage.channelsmessage.groupsmessage.immessage.mpim
Válassza a Módosítások mentése lehetőséget.
Üzenetek küldésének engedélyezése a robotnak a felhasználók által
Miután feliratkozott a roboteseményekre, engedélyezze a felhasználóknak, hogy üzenetet küldhessenek a robotnak.
- Válassza az Alkalmazás kezdőlapja lehetőséget.
- Az eredményül kapott panel Lapfül alatti Lapfülek megjelenítése szakaszában engedélyezze, hogy a felhasználók perjelparancsokat és üzeneteket küldjenek az üzenetek lapról.
Interaktív üzenetek hozzáadása és konfigurálása
Ha szeretné, engedélyezze az interaktív üzeneteket.
Válassza az Interaktivitás > parancsikonokat.
Kérés URL-címe:
- Globális robot esetén írja be a következőt
https://slack.botframework.com/api/Actions: - Regionális robot esetén adja meg a következő URL-címet a kiválasztott régió szerint:
Régió URL-cím kérése Európa https://europe.slack.botframework.com/ActionsIndia https://india.slack.botframework.com/Actions- Globális robot esetén írja be a következőt
Válassza a Módosítások mentése lehetőséget.
Az alkalmazás adatainak másolása
A Slack-csatorna robothoz való hozzáadásához a következő információkra lesz szüksége. Az alkalmazás hitelesítő adatainak másolása és tárolása mindig biztonságos helyen történik.
- Válassza az Alapszintű információk lehetőséget.
- Az eredményként kapott panelen, az Alkalmazás hitelesítő adatai területen keresse meg az ügyfélazonosítót, az ügyfél titkos kódját és az aláíró titkos kulcsot.
- Most válassza az OAuth > Engedélyek lehetőséget.
- Az eredményként kapott panelen keresse meg a Hatókörök szakaszt . Rögzítse az alkalmazás botjogkivonat-hatóköreit .
Robot konfigurálása az Azure-ban
A lépés végrehajtásához szüksége lesz a Slack-alkalmazás előző lépésben megadott hitelesítő adataira.
Nyissa meg az Azure Portalt.
Nyissa meg a robot Azure Bot-erőforrás paneljét.
Nyissa meg a Csatornák elemet, és válassza a Slack lehetőséget.
A Slack Channel konfigurációjában adja meg az előző lépésekben másolt adatokat.
- Adja meg a Slackben létrehozott alkalmazáshoz szükséges Slack-hitelesítő adatokat.
- Ha szeretné, adjon meg egy kezdőlap URL-címét , amelybe a Slack-felhasználók a robot hozzáadása után lesznek átirányítva.
- Az OAuth & Permissions Redirect URL-címének és az esemény-előfizetési kérelem URL-címének meg kell egyeznie a Slackben megadott értékekkel az átirányítási URL-cím hozzáadásához és a roboteseményre való feliratkozáshoz.
Válassza az Alkalmazás lehetőséget.
A rendszer átirányítja a Slackbe, hogy befejezze a Slack-alkalmazás telepítését.
- Ha a kért engedélyek helyesen jelennek meg, válassza az Engedélyezés lehetőséget.
A robot most már úgy van konfigurálva, hogy kommunikáljon a Slack felhasználóival. A munkaterület felhasználói mostantól a Slack alkalmazáson keresztül kezelhetik a robotot.
Az alkalmazás tesztelése a Slackben
- Jelentkezzen be a Slack-munkaterületre, ahol telepítette az alkalmazást.
- Az Alkalmazások területen válassza ki az alkalmazást.
- Az eredményül kapott panelen küldjön üzeneteket az alkalmazásnak.
További információk
Feljegyzés
2020 júniusától a Slack-csatorna támogatja a Slack V2 engedély hatóköreit, amelyek lehetővé teszik, hogy a robot részletesebben határozza meg a képességeit és engedélyeit. Minden újonnan konfigurált Slack-csatorna a V2-hatóköröket fogja használni. Ha a robotot a V2-hatókörökre szeretné váltani, törölje és hozza létre újra a Slack-csatorna konfigurációját az Azure Portal Csatornák paneljén .
A Slack robotokhoz való támogatásával kapcsolatos további információkért tekintse meg a Slack API dokumentációját:
Robot csatlakoztatása a Slackhez a Slack-adapterrel
Az Azure AI Bot Service-ben elérhető csatornán túl, amely a robotot a Slackhez csatlakoztatja, a Bot Builder-közösség adattárai meghatároznak egy egyéni csatornaadaptert a Slackhez.