Microsoft Teams’e bir Worker Üzerinden Mesaj Atmak
Selamlar,
Bugün .Net 9 ile yazılmış bir worker üzerinden nasıl Teams’deki bir user’a mesaj atabileceğimizi göreceğiz.
Öncelikle aşağıdaki gibi bir akış şeması bize en azından bir ön fikir verecektir:
1-) İlk yapılması gereken iş, Azure üzerinde App Registrations’ın yapılmasıdır. İlgili app yaratıldıktan sonra, mesajlaşma için gerekli izinlerin verilmesi gerekmektedir. Gerekli mesajlar belki biraz daha fazlası :) yazının devamında gösterilecektir.
2-) İlgili App yaratıldıktan sonra ClientID ve TenantID Overview tabından aşağıdaki gibi alınarak kaydedilmelidir.
3-) Son olarak Certificates & Secrets kısmında sadece ilk sefer görünen, “Secret Value” değeri not alınmalıdır.
4-) API permissions olarak ihtiyacıma göre aşağıdaki yetkileri verdim. Sizin hepsine ihtiyacınız olmayabilir. Daha öz halleri için, bu makaleyi ileride güncelleyebilirim.
Yetki Verme işlemi:
- Add a Permission tıklanıp aşağıda görüldüğü gibi Microsoft Graph menüsüne girilir.
- Aşağıda görüldüğü gibi alınması gereken yetkiye göre hem Delegated hem de Application permissions alanlarına gerekli izinler verilir.
Öncelikle .Net 9 Console Application oluşturuyoruz. Sonrasında kaydedilen TenantID, ClientID ve Client Secret aşağıdaki gibi değişkenlere atanır.
Teams üzerinden mesajlaşma için aşağıdaki kütüphaneler Nuget’den indirilir. Ben, tüm Teams işlemlerini Graph Library ile çözerek değişmesi muhtemel, tüm servis yollarından kurtuldum. Bir değişim olması durumunda, ilgili kütüphaneyi güncelleyerek siz de bu sorunu kolaylıkla aşabilirsiniz.
Create User:
Öncelikle ilk sefer için bir BotUser’in yaratılması gerekmektedir. Graph kütüphanesi üzerinde, birden fazla Credential yöntemi bulunmaktadır. Biz bu örnekte Azure Identity Credential kullanacağız. Aşağıdaki örnekte yaratılacak BOTUseri’ın mail adresi ve görünecek Nick’i parametrik olarak verilmiştir.
CreateUser():
Aşağıda görüldüğü gibi ilgi botUser için gerekli ayarlamalar yapılmıştır. Bu şekilde bir Guest user yaratımında mesaj atmak için, ayrıca bir sertifika tanımlamasına gerek duyulmamaktadır.
- UserType= Guest olarak ayarlanmiştır.
- “ShowInAddressList = false” olara kayarlanmış ve böylece Outlook, Teams gibi hiçbir User listesinde gelmemesi sağlanmıştır.
- “PasswordPolicies” ayarı ile atanan şifrenin hiçbir zaman expire olmaması sağlanmıştır.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 |
public static User CreateUser(GraphServiceClient graphClient, string displayName, string mail) { try { // Create a new user var user = new User { DisplayName = displayName, MailNickname = "Bot", Mail = mail, UserPrincipalName = mail, AccountEnabled = true, UserType = UserType.Guest.ToString(), ShowInAddressList = false, PasswordPolicies = "DisablePasswordExpiration, DisableStrongPassword", PasswordProfile = new PasswordProfile { ForceChangePasswordNextSignIn = false, Password = "********", }, }; // Add the user graphClient.Users.PostAsync(user).Wait(); Console.WriteLine($"User {displayName} created successfully."); return user; } catch (ServiceException ex) { Console.WriteLine($"Error creating user: {ex.Message}"); return new User(); } } |
İlgili user’ı bir seferlik yarattığımıza göre, test amaçlı bütün Userları listeletip yeni eklenen BotUser’ı hep beraber görelim.
Find UserID:
GetAllUsersList(): Aşağıda görüldüğü gibi tüm kullanıcı listesi “Azure Identity: ClientSecretCredential” ile, sayfalama da göz önüne alınarak listelenmektedir. Burada önemli olan UserID alanıdır. Graph Api üzerinde çoğu mesajlaşma işlemleri, UserIDler üzerinden yapılmaktadır.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 |
public static async Task<List> GetAllUsersList(string clientId, string tenantId, string clientSecret) { // Azure Identity: ClientSecretCredential var credential = new ClientSecretCredential(tenantId, clientId, clientSecret); // Microsoft Graph client var graphClient = new GraphServiceClient(credential); var usersList = new List(); try { // Fetch the first page of users var users = await graphClient.Users .GetAsync(requestConfiguration => { requestConfiguration.QueryParameters.Select = new[] { "displayName", "mail", "id" }; requestConfiguration.QueryParameters.Top = 100; // Optional: fetch up to 100 users per page }); // Add users to the list if (users?.Value != null) { usersList.AddRange(users.Value); } // Handle pagination while (users?.OdataNextLink != null) { // Fetch the next page of users users = await graphClient.Users .GetAsync(requestConfiguration => { requestConfiguration.QueryParameters.Top = 100; // Optional }); if (users?.Value != null) { usersList.AddRange(users.Value); } } } catch (ServiceException ex) { Console.WriteLine($"Error: {ex.Message}"); } return usersList; } |
Yeni yaratılan BotUser da ilgili listede görüldüğüne göre, sırada mesaj gönderilecek Userın ve mesajı gönderecek BotUserın, IDlerinin bulunacağı methodu yazmaya geldi.
FindUserIdByEmail(): Bu method, mesajlaşma için kullanılacak UserIDleri, userların Mailleri ile bulunmasını sağlar. Aşağıda görüldüğü gibi filitreleme amacı ile “requestConfiguration.QueryParameters.Filter” kullanılmaştır.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 |
public static async Task FindUserIdByEmail(string clientId, string tenantId, string clientSecret, string email) { // Azure Identity: ClientSecretCredential var credential = new ClientSecretCredential(tenantId, clientId, clientSecret); // Microsoft Graph client var graphClient = new GraphServiceClient(credential); try { // Kullanıcıyı e-posta ile bulma var users = await graphClient.Users .GetAsync(requestConfiguration => { requestConfiguration.QueryParameters.Filter = $"mail eq '{email}'"; requestConfiguration.QueryParameters.Select = new[] { "id", "displayName", "mail" }; }); // Eğer kullanıcı varsa ID'sini döndür if (users?.Value != null && users.Value.Count > 0) { var user = users.Value[0]; // İlk eşleşen kullanıcıyı al return user.Id; } } catch (ServiceException ex) { Console.WriteLine($"Hata: {ex.Message}"); } // Kullanıcı bulunamazsa null döndür return null; } |
Örnek kullanım şekli ve çıktı: Aşağıda görüldüğü gibi “from” ve “to” userlarin UserIDleri ilgili listede görülmektedir.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
var email = "keepnetappbot@keepnetlabs.com"; // Kullanıcının e-posta adresi var email2 = "bora.kasmer@keepnetlabs.com"; // Kullanıcı ID'sini bul var userId = await FindUserIdByEmail(clientId, tenantId, clientSecret, email); var userId2 = await FindUserIdByEmail(clientId, tenantId, clientSecret, email2); if (!string.IsNullOrEmpty(userId)) { Console.WriteLine($"Kullanıcı({email}) ID'si: {userId}"); } else { Console.WriteLine("Kullanıcı bulunamadı."); } if (!string.IsNullOrEmpty(userId2)) { Console.WriteLine($"Kullanıcı({email2}) ID'si: {userId2}"); } else { Console.WriteLine("Kullanıcı bulunamadı."); } |
Create Chat:
Artık userlarin IDlerini mailler ile bulduğumuz göre, şimdi One To One bir chat yaratabiliriz. Aşağıda görüldüğü gibi esas amacımız, bir chat yaratıp bunun da ChatID’sini alabilmektir. Chat yaratmak için burda da, gene “ClientSecretCredential” kullanılmıştır.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
// Create the 1:1 chat // Azure Identity: ClientSecretCredential var credential = new ClientSecretCredential(tenantId, clientId, clientSecret); // Microsoft Graph client var graphClient2 = new GraphServiceClient(credential); var chatId = await CreateOneOnOneChat(graphClient2, senderId, recipientId); if (!string.IsNullOrEmpty(chatId)) { Console.WriteLine($"1:1 Chat oluşturuldu. Chat ID: {chatId}"); } else { Console.WriteLine("1:1 Chat oluşturulamadı."); } |
CreateOneOnOneChat(): Mesajın, kimden kime gönderileceğinin tanımlandığı kısımdır. Bot ile kullanıcılara mesaj atma işinde from kısmı, her zaman yeni yarattığımız Userdır ve ona ait UserID kullanılır. Gönderilecek olan userın da mailinden UserID’si bulunup, ilgili Chat create edilir ve karşılığında yeni bir ChatID aşağıdaki gibi alınır.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 |
public static async Task CreateOneOnOneChat(GraphServiceClient graphClient, string senderId, string recipientId) { try { // 1:1 Chat oluşturma var chat = new Chat { ChatType = ChatType.OneOnOne, Members = new List { new AadUserConversationMember { OdataType="#microsoft.graph.aadUserConversationMember", Roles = new List { "owner" }, AdditionalData = new System.Collections.Generic.Dictionary<string, object> { {"user@odata.bind", $"https://graph.microsoft.com/v1.0/users/{senderId}"} // OData binding for sender }, UserId = senderId } as ConversationMember, // Cast to ConversationMember new AadUserConversationMember { OdataType="#microsoft.graph.aadUserConversationMember", Roles = new List { "owner" }, AdditionalData = new System.Collections.Generic.Dictionary<string, object> { {"user@odata.bind", $"https://graph.microsoft.com/v1.0/users/{recipientId}"} // OData binding for recipient }, UserId = recipientId } as ConversationMember // Cast to ConversationMember } }; // Chat oluştur ve ID'sini al var createdChat = await graphClient.Chats.PostAsync(chat); return createdChat.Id; } catch (ServiceException ex) { Console.WriteLine($"Hata: {ex.Message}"); return null; } } |
Send Message:
Artık Chat’imizi üretip chatID’yi de aldığımıza göre, bunu ilgili kişiye gönderebiliriz.
|
1 2 3 |
UsernamePasswordCredential usernamePasswordCredential = new UsernamePasswordCredential("keepnetappbot@keepnetlabs.com", "******", tenantId, clientId); GraphServiceClient graphClient = new GraphServiceClient(usernamePasswordCredential, scopes); await SendMessageToChat(graphClient, chatId, "Merhaba, sizin için atanmış bir eğitim bulunmaktadır. Lütfen eğitim detaylarını inceleyip tamamlamayı unutmayınız."); |
Yukarıdaki düz text mesaj yerine, aşağıda görüldüğü gibi HTML bir sayfa da Teams’den mesaj olarak gönderilebilir. Yukarıda dikkat edildi ise “ClientSecretCredential()” yerine “UsernamePasswordCredential()” ile mesaj atma operasyonunu, yetki hatasına takılmadan başarabildim. Burada girilen username ve şifre, yeni yaratılan BotUser’a aittir. Bu şifre ve passwordün cloud üzerinde tutulması, güvenlik açısından çok daha iyi olacaktır. Makalenin ana konusundan uzaklaşılmaması adına, bu şekilde yani doğrudan bir giriş yapılmıştır. İlgili makaleye buradan erişebilirsiniz.
SendMessageToChat():
Aşağıda görüldüğü gibi Html bir mesaj tipi gönderildiği için, Body içerisinde “ContentType = BodyType.Html” olarak tanımlanmıştır. Ayrıca “graphClient.Chats[chatId]” ile yukarıda yaratılan chat bulunmuş ve aşağıda oluşturulan “ChatMessage” ile ilgili kişiye gönderilmiştir.
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
public static async Task SendMessageToChat(GraphServiceClient graphClient, string chatId, string message) { try { var chatMessage = new ChatMessage { Body = new ItemBody { ContentType = BodyType.Html, Content = message } }; // Send the message to the chat await graphClient.Chats[chatId].Messages.PostAsync(chatMessage); Console.WriteLine($"Message sent to chat {chatId}: {message}"); } catch (ServiceException ex) { Console.WriteLine($"Error sending message: {ex.Message}"); } } |
Örnek Teams’den Giden Mesaj: Aşağıda görüldüğü gibi, Teams üzerinden bir botdan gerçek bir user’a Html bir mesaj başarı ile gönderilmiştir.
Geldik bir makalenin daha sonuna. Bu makalede bir Console Application ya da daha gerçekçi bir senaryo ile bir .Net Microservisden nasıl Teams üzerinde bir User’a mesaj gönderebileceğimiz konusu detaylıca inceledik.
Yeni bir makalede görüşmek üzere hepinize hoşçakalın.
Github: https://github.com/borakasmer/SendMessageToTeams/tree/main
Source:
- https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app?tabs=certificate
- https://learn.microsoft.com/en-us/graph/api/chat-post?view=graph-rest-1.0&tabs=csharp
- https://github.com/microsoftgraph/msgraph-sdk-dotnet/blob/main/docs/tokencredentials.md
- https://learn.microsoft.com/en-us/graph/api/chat-post-messages?view=graph-rest-1.0&tabs=csharp
Son Yorumlar