{"id":5834,"date":"2021-08-26T08:00:22","date_gmt":"2021-08-26T08:00:22","guid":{"rendered":"https:\/\/www.process.st\/help\/docs\/gmail\/"},"modified":"2024-03-07T11:31:29","modified_gmt":"2024-03-07T11:31:29","slug":"gmail","status":"publish","type":"ht_kb","link":"https:\/\/www.process.st\/help\/docs\/gmail\/","title":{"rendered":"Gmail + Process Street Integration"},"content":{"rendered":"<p><img decoding=\"async\" class=\"alignnone size-full wp-image-9680\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Integrate-Gmail-with-Process-Street-04.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>You can integrate <a href=\"https:\/\/www.google.com\/gmail\/about\/\">Gmail<\/a> with <a href=\"https:\/\/www.process.st\/\">Process Street<\/a> <a href=\"https:\/\/www.process.st\/help\/docs\/running-checklists\/\">workflow runs<\/a> using <a href=\"https:\/\/www.process.st\/what-is-zapier\/\">Zapier<\/a>.<\/p>\n<p>Information you receive by email in Gmail can be used to automatically run and populate workflow runs in Process Street. This means that you don&#8217;t have to manually sort through your emails and run your workflows to process them &#8211; they can be automatically detected and arranged into tasks to process from your Process Street Inbox.<\/p>\n<p>If you\u2019d like to know more about automating your processes in general, check out our free <a href=\"https:\/\/www.process.st\/business-process-automation-guide\/\">business process automation guide<\/a>\u00a0and our own direct <a href=\"https:\/\/www.process.st\/help\/docs\/automations\/\">Automations<\/a>.<\/p>\n<p><em><strong>Plan: This integration is available to customers on <a href=\"https:\/\/www.process.st\/pricing\/\">all plans<\/a>.<\/strong><\/em><\/p>\n<p><em><strong>Users: In order to create an API key for integrations, you must be an Administrator.<\/strong><\/em><\/p>\n<h2>Use case:<\/h2>\n<ul>\n<li>A company manages its user feedback process with Process Street<\/li>\n<li>The company wants to automatically run a <a href=\"https:\/\/www.process.st\/templates\/user-feedback-processing-checklist\/\">user feedback workflow<\/a> when receiving feedback through Gmail create an event in Google Calendar to log the time of the initial meeting with the client<\/li>\n<\/ul>\n<h2>Process overview:<\/h2>\n<ul>\n<li>We will add form fields to a Process Street workflow<\/li>\n<li>We will set up our \u201cUser Feedback\u201d label in Gmail<\/li>\n<li>We will make a Zap in <a href=\"https:\/\/www.process.st\/help\/docs\/zapier\/\">Zapier<\/a> that runs your workflow in Process Street when you label an email you receive as \u201cUser Feedback\u201d<\/li>\n<li>We will configure the Zap to pull information from the email into the form fields in your workflow run to save the hassle of data entry<\/li>\n<\/ul>\n<p>Let\u2019s get this set up!<\/p>\n<h2>Add form fields to your workflow<\/h2>\n<p>First, we need to add <a href=\"https:\/\/www.process.st\/help\/docs\/form-fields\/\">form fields<\/a> into our user feedback processing workflow in Process Street. These can be used to record data when filling out the workflow run, which we will later use to store information from the email you receive in Gmail as a new event.<\/p>\n<p>You can add form fields when\u00a0<a href=\"https:\/\/www.process.st\/help\/docs\/editing-templates\/\">editing one of your workflows<\/a>.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11017\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-forms-added.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>In this case, we\u2019ve set up form fields to capture the following information:<\/p>\n<ul>\n<li>Feedback source<\/li>\n<li>Feedback date<\/li>\n<li>User email address<\/li>\n<li>Original message<\/li>\n<\/ul>\n<p>While there are other form fields that have been added to the workflow, these are for later action and aren&#8217;t needed to get your Gmail integration up and running.<\/p>\n<p>Add form fields to your own workflow to make space for any information you think will be relevant when processing your user feedback email (such as the elements above). Alternatively, you can always grab our free workflow template below and edit it to your needs to accomplish the same thing.<\/p>\n<p><iframe loading=\"lazy\" src=\"https:\/\/www.process.st\/templates\/user-feedback-processing-checklist\/\" width=\"100%\" height=\"600\" frameborder=\"0\"><\/iframe><\/p>\n<p>After that, it\u2019s time to make sure that your label is set up in Gmail to signal to Zapier that it needs pushing into your workflow run.<\/p>\n<h2>Set up your \u201cUser Feedback\u201d label in Gmail<\/h2>\n<p>Next, you need to set up your label in Gmail so that you can easily label the messages your receive appropriately. This will also let Zapier know what emails should be pushed into a new workflow run and which should not.<\/p>\n<p>There\u2019s not much to this step, other than that you\u2019ll need to have an account set up and the label created.<\/p>\n<p>Just log into your Gmail account (or create a free account if you don&#8217;t have one) and click \u201cCreate new label\u201d&#8230;<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11018\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-create-label-min.gif\" alt=\"\" width=\"100%\" \/><\/p>\n<p>&#8230; then pick the name for your new label e.g &#8220;User Feedback&#8221; and click \u201c<strong>Create<\/strong>\u201d.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11021\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-create-new-label.png\" alt=\"\" width=\"100%\" \/><\/p>\n<h2>Make a Zap to run your workflow when you label an email in Gmail<\/h2>\n<p><a href=\"https:\/\/zapier.com\/\">Zapier<\/a> is a tool that connects over 2,000 different apps. Any action in the supported apps (like forwarding an email or adding an attachment to a task) can be set up to trigger another app\u2019s features automatically. Zapier integrates with both Gmail and Process Street. The whole recipe (Trigger + Action) is called a Zap.<\/p>\n<p>Log into <a href=\"http:\/\/zapier.com\/\">Zapier<\/a> or <a href=\"https:\/\/zapier.com\/sign-up\">create an account<\/a>, then click &#8220;<strong>Make a Zap<\/strong>&#8220;.<\/p>\n<p>In your new Zap, select Gmail as the app and choose &#8220;<strong>New Labeled Email<\/strong>&#8221; as the trigger.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11022\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-trigger.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Click &#8220;<strong>Continue<\/strong>&#8221; connect your Gmail account, and click &#8220;<strong>Continue<\/strong>&#8221; again to move onto the &#8220;Set up trigger&#8221; step.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-11023\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-set-up-trigger.png\" alt=\"\" width=\"1024\" height=\"512\" \/><\/p>\n<p>From the dropdown menu, select the label that we set up earlier, then click &#8220;<strong>Continue<\/strong>&#8220;.<\/p>\n<p>Before you go on to test your trigger in Zapier, make sure you\u2019ve recently labeled an email as \u201cUser Feedback\u201d &#8211; you can always send yourself an email to test this out. Otherwise, Zapier won&#8217;t have any sample data to pull in and validate.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11024\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-trigger-success.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Congratulations! You\u2019ve just set up Gmail as your Trigger for the Zap. Next it\u2019s time to set up Process Street as your Action step.<\/p>\n<h2>Configure the Zap to create and populate your workflow runs in Process Street<\/h2>\n<p>Choose Process Street as your app and \u201c<strong>Run Workflow<\/strong>\u201d as the action. This tells Zapier to run your workflow in Process Street when it detects that you&#8217;ve labeled an email as in the previous section of this article.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11025\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-run-workflow.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Connect your Process Street account and then move on to choosing and setting up the workflow you will run.<\/p>\n<p>Here you need to select the workflow that you will run using the dropdown.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11026\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-map-fields.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Once that&#8217;s done, all that you have left to do is to map data to the form fields in your workflow run with information from your email in Gmail.<\/p>\n<p>Do this by clicking the field you&#8217;d like to map data into, and then use either the dropdown or search bar to find the information you want to push through.<\/p>\n<p>In this example, I linked:<\/p>\n<ul>\n<li>The \u201cWorkflow Run Name\u201d and \u201cUser Email Address\u201d to be the email address of the person who sent the email<\/li>\n<li>The &#8220;Feedback Source&#8221; as Gmail<\/li>\n<li>The \u201cFeedback Date\u201d to be the date the email was sent<\/li>\n<li>The \u201cOriginal Message\u201d field to contain the body text of the email<\/li>\n<\/ul>\n<p>Continue through to the test phase and make sure your test is a success.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11027\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-action-success.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Next, head over to your Process Street reports ensuring that your workflow run has been created and populated correctly.<\/p>\n<p><img decoding=\"async\" class=\"alignnone size-full wp-image-11028\" src=\"https:\/\/www.process.st\/help\/wp-content\/uploads\/2024\/02\/Gmail-ooutput.png\" alt=\"\" width=\"100%\" \/><\/p>\n<p>Once that\u2019s done, name and turn on your Zap, then test it out again by sending yourself a test email and assigning the label that we set up earlier to it. Make sure that your workflow run is created correctly with all of the relevant information in the right place.<\/p>\n<p>And there you have it! Here\u2019s to saving time and energy that\u2019s better spent on your more important tasks.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>You can integrate Gmail with Process Street workflow runs using Zapier. Information you receive by email in Gmail can be used to automatically run and populate workflow runs in Process Street. This means that you don&#8217;t have to manually sort through your emails and run your workflows to process them &#8211; they can be automatically [&hellip;]<\/p>\n","protected":false},"author":4,"template":"","meta":{"_acf_changed":false,"available_plan":"All plans","available_product":"Integrations","footnotes":""},"ht_kb_category":[194],"ht_kb_tag":[354,280],"class_list":["post-5834","ht_kb","type-ht_kb","status-publish","hentry","ht_kb_category-integrations","ht_kb_tag-gmail","ht_kb_tag-integration"],"acf":[],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5834","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb"}],"about":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/users\/4"}],"version-history":[{"count":1,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5834\/revisions"}],"predecessor-version":[{"id":5835,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb\/5834\/revisions\/5835"}],"wp:attachment":[{"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/media?parent=5834"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_category?post=5834"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.process.st\/help\/wp-json\/wp\/v2\/ht_kb_tag?post=5834"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}