Messaging and Communication Jobs

The following topics describe job types for messaging and communication platforms and services.

Job:Communication Suite

Communication Suite enables you to automate business messaging and communication over Microsoft Teams, Slack, Telegram, and WhatsApp.

To deploy and run a Communication Suite job, ensure that you have done the following:

• Configured the Control-M Application Integrator plug-in, as described in Application Integrator Configuration.

• Installed the Communication Suite plug-in with the provision image command (Control-M/EM 9.0.21 or higher) or the deploy jobtype command (Control-M/EM 9.0.20.200 or lower).

The following examples show how to define a Communication Suite job.

• This JSON defines a job for Microsoft Teams:

  Copy

  "Communication Suite_Job_Teams": {
     "Type": "Job:Communication Suite",
     "ConnectionProfile": "COMM_SUITE",
     "Application Name": "Microsoft Teams",
     "Teams Parameters":"{ "type":"message", "attachments":[ {"contentType":"application/vnd.microsoft.card.adaptive",
        "contentUrl":null, "content":{ "$schema":"http://adaptivecards.io/schemas/adaptive-card.json","type":"AdaptiveCard","version":"1.2",
        "body":[{"type": "TextBlock","text": "For Samples and Templates, see [https://adaptivecards.io/samples](https://adaptivecards.io/samples)" } ] } }]}",
     "Silent Message": "unchecked",
     "Protect Content": "unchecked"
  }

• This JSON defines a job for Slack:

  Copy

  "Communication Suite_Job_Slack": {
     "Type": "Job:Communication Suite",
     "ConnectionProfile": "COMM_SUITE",
     "Application Name": "Slack",
     "Slack Parameters":"{"blocks": [{"type": "section","text": {"type": "mrkdwn","text": "The job finished successfully orderid: %%ORDERID, and <https://google.com|this is a link>"}}]}",
     "Silent Message": "unchecked",
     "Protect Content": "unchecked"
  }

• This JSON defines a job for Telegram:

  Copy

  "Communication Suite_Job_Telegram": 
  {
     "Type": "Job:Communication Suite",
     "ConnectionProfile": "COMM_SUITE",
     "Application Name": "Telegram",
     "Telegram Parameters":"The job finished successfully orderid: %%ORDERID",
     "Silent Message": "unchecked",
     "Protect Content": "unchecked"
  }

• This JSON defines a job for WhatsApp:

  Copy

  "Communication Suite_Job_WhatsApp": {
     "Type": "Job:Communication Suite",
     "ConnectionProfile": "COMM_SUITE",
     "Application Name": "WhatsApp",
     "WhatsApp Parameters":" { "messaging_product": "whatsapp", "to": "17181231234", "type": "template", "template": { "name": "control_m", "language": { "code": "en" } }}",
     "Silent Message": "unchecked",
     "Protect Content": "unchecked"
  }

The following table describes the Communication Suite job parameters.

Parameter	Description
Connection Profile	Defines the ConnectionProfile:Communication Suite name that connects Control-M to Communication Suite.
Application Name	Determines one of the following communications platforms to use: Microsoft Teams: An instant-messaging, media sharing, file storage, application integration, and voice, and video call service that runs on a computer or phone and does not require a phone number. Slack: An instant-messaging, media sharing, and voice and video call service that runs on a computer or phone and does not require a phone number. Telegram: An instant-messaging, end-to-end encrypted chat, and voice-over-IP (VoIP) voice and video call service that requires a mobile telephone number. WhatsApp: An instant-messaging and voice-over-IP (VoIP) voice and video call service that requires a mobile telephone number.
Teams Parameters	Defines the parameters, in JSON format, that instruct Teams to perform multiple actions. For more information about the supported parameters, see the Microsoft Teams documentation.
Slack Parameters	Defines the parameters, in JSON format, that instruct Slack to perform multiple actions. For more information about the supported parameters, see the Slack documentation.
Telegram Parameters	Defines the parameters, in simple text format, that instruct Telegram to perform multiple actions. Rule: 1–4,096 characters You can add Control-M variables to the text.
Silent Message	Determines whether to send your Telegram message without a notification, which is useful for after-hours or non-urgent messages.
Protect Content	Determines whether to prevent your Telegram message from being saved or forwarded.
WhatsApp Parameters	Defines the parameters, in JSON format, that instruct WhatsApp to perform multiple actions. For more information about the supported parameters, see the WhatsApp documentation.