| At line 1 added one line |
| \\ |
| At line 3 changed 3 lines |
| __!!! Proxy Configuration:__ If your server accesses the internet through a proxy, make sure to whitelist the following domains to allow authentication and Microsoft Graph API access:\\ |
| • login.microsoftonline.com\\ |
| • graph.microsoft.com\\ |
| ---- |
| __⚠️ Proxy Configuration:__ If your server accesses the internet through a proxy, make sure to whitelist the following domains to allow authentication and Microsoft Graph API access:\\ |
| •__login.microsoftonline.com__\\ |
| •__graph.microsoft.com__\\ |
| ---- |
| At line 7 changed one line |
| !Microsoft Graph Application Registration |
| !1. Microsoft Graph Application Registration\\ |
| At line 19 changed one line |
| The Redirect URL must end with __"register_microsoft_graph_api/"__.\\ |
| In the Redirect URI section, for Platform configuration, select __Web__. The Redirect URL must end with __"register_microsoft_graph_api/"__.\\ |
| At line 27 added 2 lines |
| or |
| https://your.crushftp.domain.com/register_microsoft_graph_api/ |
| At line 26 removed 6 lines |
| or |
| {{{ |
| |
| https://your.crushftp.domain.com/register_microsoft_graph_api/ |
| |
| }}}\\ |
| At line 33 changed one line |
| __Secret key__: A new client secret must be created. Go to Certificates & secrets, and generate a new client secret by clicking on New client secret. Ensure you copy over the __value__ immediately!\\ |
| __Secret key__: A new client secret must be created. Go to Certificates & secrets, and generate a new client secret by clicking on New client secret. ⚠️ Ensure you copy over the __value__ immediately!\\ |
| At line 49 changed one line |
| To grant permissions for CrushFTP, click the Get Admin Consent button. Make sure the WebInterface host and port match the host and port specified in the App Registration’s __Redirect URL__.\\ |
| Grant __Admin consent__ for the newly added permission.\\ |
| At line 50 added 4 lines |
| [SharePoint Integration/app_permission_admin_consent.png]\\ |
| \\ |
| Alternatively, you can perform this action via __CrushFTP__: Click the __Get Admin Consent__ button. __⚠️ Note:__ Make sure the WebInterface host and port match the host and port specified in the App Registration’s __Redirect URL__.\\ |
| \\ |
| At line 56 changed one line |
| Any changes made to __API permissions__ in the __Azure App Registration__ require new admin consent.\\ |
| ⚠️ Any changes made to __API permissions__ in the __Azure App Registration__ require new admin consent.\\ |
| At line 58 changed one line |
| !Settings\\ |
| ---- |
| !2. Task Settings\\ |
| At line 62 changed 4 lines |
| Client ID, Client Secret, Tenant: Authentication-related setting. Azure App registration -> Overview.\\ |
| Folder: Supports subfolders too like Folder/Subbolder/SubSubFolder\\ |
| Search query: Search settings for messages. See [https://docs.microsoft.com/en-us/graph/query-parameters#search-parameter].\\ |
| After processing copy message to this mailbox: Supports subfolders too.\\ |
| __Client ID__ : See at App Registration -> Overview -> Application (client) ID\\ |
| __Client Secret__: See at App Registration -> Manage -> Certificates & secrets) make sure to copy the value field, not the ID\\ |
| __Tenant__: See at App Registration -> Overview -> Directory (tenant) ID\\ |
| At line 67 changed one line |
| Variable patterns:\\ |
|
| __Folder__: Specifies the mail folder to process. Supports subfolders using the format Folder/Subbolder/SubSubFolder\\ |
| __Search query__: Defines the search criteria for messages. It uses a specific syntax called Keyword Query Language ([KQL|https://learn.microsoft.com/en-us/sharepoint/dev/general-development/keyword-query-language-kql-syntax-reference]). In this language, the asterisk (*) wildcard is only supported for prefix matching (e.g., subject:report*). It does not have a character or function for suffix (*report) or contains (*report*) matching. Refer to the Microsoft Graph Search Parameters for syntax and options. More info: [Microsoft Graph Search Parameter Link|https://learn.microsoft.com/en-us/graph/search-query-parameter?tabs=http].\\ |
| __Examples__: |
| {{{ |
| from |
|
| Searches the display name and email address of the sender. |
| Example: from:"John Doe" or from:john.doe@example.com |
| }}}\\ |
| {{{ |
| to |
|
| Searches the display names and email addresses in the To: line. |
| Example: to:marketing |
| }}}\\ |
| {{{ |
| cc |
|
| Searches the display names and email addresses in the Cc: line. |
| Example: cc:jane.doe@example.com |
| }}}\\ |
| {{{ |
| bcc |
|
| Searches the display names and email addresses in the Bcc: line. |
| Example: bcc:"Project Leads" |
| }}}\\ |
| {{{ |
| recipients |
|
| Searches across all recipient fields (to, cc, and bcc) simultaneously. |
| Example: recipients:management |
| }}}\\ |
| {{{ |
| subject |
|
| Searches the subject line of the message. For phrases, use double quotes. |
| Example: subject:"Q4 Financial Report" |
| }}}\\ |
| {{{ |
| body |
|
| Searches the content of the message body. |
| Example: body:invoice or body:"Action Required" |
| }}}\\ |
| {{{ |
| attachment |
|
| Searches the file names of attachments. |
| Example: attachment:presentation.pptx |
| }}}\\ |
| {{{ |
| sent |
|
| Searches for messages sent on a specific date. You can use date keywords or specific dates in YYYY-MM-DD, YYYY-MM-DDThh:mm:ss, YYYY-MM-DDThh:mm:ssZ, or YYYY-MM-DDThh:mm:ssfrZ format. |
| Example: sent:yesterday or sent:2025-10-14 |
| }}}\\ |
| {{{ |
| received |
|
| Searches for messages received on a specific date. |
| Example: received:last week or received:>=2025-10-01 |
| }}}\\ |
| {{{ |
| hasattachment |
|
| Searches for messages that have at least one attachment. This is a boolean search. |
| Example: hasattachment:true |
| }}}\\ |
| {{{ |
| importance |
|
| Searches for messages with a specific importance level. |
| Example: importance:high |
| }}}\\ |
| {{{ |
| isread |
|
| Searches for messages based on their read status. |
| Example: isread:false |
| }}}\\ |
| {{{ |
| size |
|
| Searches for messages based on their size in bytes. You can use range operators (>, <, >=, <=). |
| Example: size:>5000000 (for messages larger than 5MB) |
| }}}\\ |
| At line 69 changed one line |
| Message-related variables:\\ |
| __After processing copy message to this mailbox__: Specifies the destination mailbox for processed messages. Subfolders are also supported.\\ |
| \\ |
| __Variable patterns:__\\ |
| \\ |
| a.) Message-related variables:\\ |
| \\ |
| At line 71 changed 2 lines |
| {mail_id}, {mail_createdDateTime}, {mail_lastModifiedDateTime}, {mail_hangeKey}, {mail_sentDateTime}, {mail_receivedDateTime}, {mail_hasAttachments}, {mail_internetMessageId}, {mail_subject}, {mail_body_content}, {mail_body_type}, {mail_importance}, {mail_parentFolderId}, {mail_conversationId}, {mail_isRead}, {mail_isDraft}, {mail_sender}, {mail_from} , {mail_to}, {mail_cc}, {mail_bcc}, {mail_reply_to} |
| }}} \\ |
| {mail_id},{mail_hangeKey},{mail_internetMessageId},{mail_parentFolderId},{mail_conversationId} |
|
| {mail_from},{mail_sender},{mail_to},{mail_cc},{mail_bcc},{mail_reply_to} |
|
| {mail_subject}, {mail_body_content},{mail_body_type} |
|
| {mail_createdDateTime}, {mail_lastModifiedDateTime},{mail_sentDateTime}, {mail_receivedDateTime} |
| |
| {mail_hasAttachments},{mail_importance},{mail_isRead},{mail_isDraft}, |
| }}}\\ |
| At line 74 changed one line |
| Attachment-related variables:\\ |
| b.) Attachment-related variables:\\ |
| \\ |
| At line 77 changed one line |
| }}} |
| }}}\\ |
| \\ |
| For alternatives, see the general POP/IMAP Task description: [POP/IMAP Task – CrushFTP Documentation Link| https://www.crushftp.com/crush11wiki/Wiki.jsp?page=CrushTask#section-CrushTask-POP3IMAP]\\ |
