Skip to main content


This Script is part of the Microsoft Teams Pack.#

Send a team member or channel a question with predefined response options on Microsoft Teams. The response can be used to close a task (might be conditional) in a playbook.

Script Data#

Script Typepython3
Cortex XSOAR Version5.0.0


This script uses the following commands and scripts.

  • send-notification


Argument NameDescription
messageQuestion (message) to send to the specified team member or channel.
persistentIndicates whether to use one-time entitlement or persistent entitlement.
option1First reply option.
option2Second reply option.
additional_optionsA CSV list of additional options (in case more than 2 options are required).
team_memberTeam member to which to send the question.
task_idTask ID of the playbook task to close with the reply. If not provided, no playbook task will be closed.
channelChannel to which to send the question.
teamThe team in which to mirror the Cortex XSOAR investigation. If not specified, the default team configured in the integration parameters will be used.


There are no outputs for this script.


The MicrosoftTeamsAsk script sends a message, such as operation approval or information retrieval, in a question format from Cortex XSOAR to Microsoft Teams. The message must have at least two options. For example, "yes" and "no".

After the question is answered in Microsoft Teams, the response is sent to the Cortex XSOAR server, which appears as a conditional task in a playbook with response options as conditions. Depending on the response, the workflow may continue. For example, you define the following arguments:

  • option1: yes
  • option2: no

If a team member responds "yes" the playbook continues running the "yes" branch.

If a task ID is included in the script, and the task condition is met, the playbook closes as soon as a response is received.