# salt.states.msteams

## Send a message card to Microsoft Teams

This state is useful for sending messages to Teams during state runs.

Added in version 2017.7.0.

    teams-message:
      msteams.post_card:
        - message: 'This state was executed successfully.'
        - hook_url:  https://outlook.office.com/webhook/837

The hook_url can be specified in the master or minion configuration like below:

    msteams:
      hook_url: https://outlook.office.com/webhook/837

salt.states.msteams.post_card(name, message, hook_url=None, title=None, theme_color=None)

  Send a message to a Microsft Teams channel

      send-msteams-message:
        msteams.post_card:
          - message: 'This state was executed successfully.'
          - hook_url: https://outlook.office.com/webhook/837

  The following parameters are required:

  message

    The message that is to be sent to the MS Teams channel.

  The following parameters are optional:

  hook_url

    The webhook URL given configured in Teams interface, if not specified in the configuration options of master or minion.

  title

    The title for the card posted to the channel

  theme_color

    A hex code for the desired highlight color