Wait For Email Reply action
Summarize
Summary of Wait For Email Reply action
The Wait For Email Reply action in ServiceNow allows you to pause a flow until a reply is received to a specified outbound email record. This Core action is useful for automating processes that depend on receiving email feedback, such as incident management or customer communications.
Show less
Inputs
- Record [Email]: Reference to the outbound email (sysemail) the flow waits a reply for. The email must have a populated target record and be of an outbound type like "sent" or "send-ready". Outbound types can be adjusted via system properties.
- Enable Timeout: Boolean option to limit how long the flow waits for a reply before continuing.
- Duration: Specifies the length of the wait period if timeout is enabled, entered in hours, minutes, and seconds.
- Schedule: Optional schedule record to calculate timeout duration based on business hours (e.g., 8-5 weekdays). If omitted, timeout runs continuously.
Outputs
- Email Reply: Reference to the inbound email reply received.
- State: Numeric status indicating completion:
- 0 = Success (reply received)
- 1 = Error (no reply received)
General Guidelines
- Use a timeout to prevent indefinite pauses. Preferably set in days to allow for email processing delays.
- Handle no-reply scenarios by checking the State output and branching flow logic accordingly.
- Leverage Email Reply output to trigger further actions, such as updating records based on reply content.
- Use Send Email action output as input to this action for seamless flow integration.
- If the email already has a reply, the flow does not pause and progresses using the existing reply data.
Practical Example
In an incident management flow, after sending a resolution update email, the Wait For Email Reply action can wait up to three business days for a reply. If a reply arrives, the incident state updates to Work in Progress for further review. If no reply is received, the incident is automatically closed, ensuring timely case resolution.
Pause a flow until an email reply is received to an outbound email record
Roles and availability
This action is a ServiceNow Core action.
Inputs
Provide a value for each input that your action needs. To add dynamic values, you can also select data pills using the pill picker.
- Record [Email]
- Data type: Reference
The Email [sys_email] record that you want the action to wait for a reply to.Note:The email record has to meet the following requirements to be valid:
- The target record field of the email has to be populated.
- The email record that you select must be an outbound email type such as "sent" or "send-ready." You can change the types of outbound email through the com.glide.hub.flow_engine.wait_for_email_reply_input_state system property. For more information, see Workflow Studio flow system properties
- Enable Timeout
- Data type: True/False
Option to limit the amount of time that the flow waits for the action to be completed before continuing.
- Duration
- Data type: Duration
Amount of time that the flow waits before continuing when the Enable timeout option is selected. Enter the time to wait in hours, minutes, and seconds. If you leave this field empty, the flow doesn’t wait.
- Schedule
- Data type: Record
Schedule record used to compute the timeout duration when the Enable timeout option is selected. For example, waiting for 10 hours as part of an 8-5 weekdays schedule causes the flow to wait for one or more business days. If you leave this field empty, the timeout runs without a schedule.
Outputs
The following outputs appear in the Data panel. You can use them as inputs elsewhere in your flow.
- Email Reply
- Data type: Record
The Email [sys_email] record that was sent in reply to the input email record.
- State
- Data type: Choice
The completion status of the action as a numeric value.
- 0 (Success: There was an email reply)
- 1 (Error: There was no email reply)
General Guidelines
- Add a timeout duration for the Wait for Email Reply action
- Add a timeout value to prevent your flow from pausing indefinitely if no reply is ever received. Use a timeout duration greater than a few hours and preferably in days. The timeout value needs to provide sufficient time for the instance to process outbound email in the "send-ready" state and also time for the instance to process inbound email replies. You can use a timeout value along with the Status output to handle cases when an email message never receives a reply. For example, you can use an If flow logic block to check for a status value of 1 and then have your flow continue based on there being no reply.
- Use the Email Reply output as input data for other flow actions
- You can use the content of the Email Reply as data for another flow action. For example, you could update an Incident record with the contents of a reply or use the lack of a reply to set the state of an incident to closed.
- Use the Send Email action as an input
- You can use the output of the Send Email action as the input of the Wait for Email Reply action.
- Emails with existing replies don’t pause the flow
- If the email input already has an existing reply, the flow doesn’t pause on the action. In that case, the outputs are populated with a reference to the existing email reply and the flow progresses normally.
Wait for an email reply about a resolved incident
In this example flow, the flow sends an email when an incident update is resolved. The Wait For Email Reply action waits for three business days for a reply. If there’s a reply, the incident record state is updated to Work in Progress for an agent to review. If there’s no reply, the incident record is updated to the Closed state.