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 installed the Communication Suite plug-in with the provision image command or the provision agent::update command.
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:
|
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. |