EPIC: FOUR-32115 Microsoft Graph Integration - #8906
Open
sanjacornelius wants to merge 12 commits into
Open
Conversation
Introduce MicrosoftGraphTokenProvider to obtain and cache OAuth2 client-credentials tokens from Microsoft Graph. The provider validates required credentials, posts to the tenant token endpoint via Guzzle, throws a RuntimeException on missing creds or HTTP errors (propagating server error messages), and caches the access token for ~50 minutes using a server-specific cache key. Includes unit tests that assert exception behavior for missing credentials and mock Guzzle to verify token request parameters and caching behavior.
Add an optional Guzzle Client dependency to MicrosoftGraphTokenProvider so an HTTP client can be injected for testing. The constructor now accepts ?Client $httpClient and the provider uses $this->httpClient ?? new Client() when posting for tokens. Update the unit test to mock GuzzleHttp\Client (remove overload-based mock and separate-process annotations), import Client, and pass the mocked client into the provider. This enables dependency injection and simpler, more reliable tests.
Replace Mockery-based response mocks in MicrosoftGraphTokenProviderTest with an actual GuzzleHttp\Psr7\Response instance. Simplifies the test by providing a real PSR-7 response (200) with a JSON body and removes the need to mock getBody()/getContents() and getStatusCode(). Added the Response use statement.
Add Microsoft Graph token provider with client credentials flow and unit tests
Introduce Microsoft Graph mail support: add MicrosoftGraphTransport and MicrosoftGraphMessageConverter to send emails via the Graph API and a MicrosoftGraphTokenProvider to obtain access tokens. Integrate the transport into OauthMailManager (createTransport/createMicrosoftGraphTransport) and register a 'microsoft_graph' mailer in config/mail.php. Update the admin settings UI to show the authorization button when the mail driver is set to 'microsoft_graph'. The transport posts a sendMail payload to the Graph endpoint and throws a TransportException on HTTP errors.
|
QA server K8S was successfully deployed https://ci-35f64bfa59.engk8s.processmaker.net |
Add Microsoft Graph Mail Transport and Configuration
|
QA server K8S was successfully deployed https://ci-35f64bfa59.engk8s.processmaker.net |
Drop the use of Illuminate\Support\Facades\Cache and the Cache::remember call so getAccessToken always calls requestAccessToken.
Add convertAttachments() to MicrosoftGraphMessageConverter to map Symfony Email attachments to Microsoft Graph fileAttachment objects (name, contentType, contentBytes base64) and include them in toSendMailPayload when present.
Remove Microsoft Graph Configuration Caching
|
QA server K8S was successfully deployed https://ci-35f64bfa59.engk8s.processmaker.net |
Include File Attachments in Microsoft Graph Emails
|
|
QA server K8S was successfully deployed https://ci-35f64bfa59.engk8s.processmaker.net |
sanjacornelius
changed the title
eiresendez
self-requested a review
August 1, 2026 15:13
eiresendez
approved these changes
Aug 1, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR adds Microsoft Graph support to the Send Email connector, allowing users to send emails through Microsoft 365 using the Microsoft Graph API.
The integration uses the OAuth2 client credentials flow to authenticate with Azure and send emails without relying on traditional SMTP authentication. It also includes support for connection validation, token management, and sending file attachments through Microsoft Graph.
ci:connector-send-email:epic/FOUR-32115
Solution
How to Test
Related Tickets & Packages
Code Review Checklist