Messaging and Communication Connection Profiles

The following topics describe connection profiles for messaging and communication platforms and services:

ConnectionProfile:Communication Suite

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

The following example shows how to define a Communication Suite connection profile:

Copy
"COMM_SUITE"
{
   "Type": "ConnectionProfile: Communication Suite",
   "Microsoft Teams Webhook URL": "https://x3dmj.webhook.office.com/webhookb2/5dbb288-138d-428d-ade7-478f727d93f3@edc0dae-4a7f-ac1e-91cb8a656e/IncomingWebhook/ba207b3181d9ede7c9ad1251141/05f0a54e-cec1-4df4-893b-8e61d84516a"
   "Slack Webhook URL": "https://hooks.slack.com/services/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",
   "Telegram URL": "https://api.telegram.org/bot",
   "Telegram Bot Token": "*****",
   "Telegram Chat ID": "207397578157",
   "WhatsApp URL": "https://graph.facebook.com/Version/PhoneNumberID/messages",
   "WhatsApp Business ID": "142913904062636",
   "Phone Number ID": "790951673835859",
   "Recipient Phone Number": "17185551212",
   "User Access Token": "*****",
   "Version": "v15.0",
   "Connection Timeout": "30",
   "Description": "",
   "Centralized": true
}

The following table describes the Communication Suite connection profile parameters.

Parameter

Description

Microsoft Teams Webhook URL

Defines an incoming webhook, which enables Control-M to communicate over Microsoft Teams channels.

You must create this webhook in Teams before you can add it to the connection profile.

Slack Webhook URL

Defines an incoming webhook, which enables Control-M to communicate over Slack channels.

You must create this webhook in Slack before you can add it to the connection profile.

Telegram URL

Determines the authentication endpoint for Telegram, which enables Control-M to connect to a Telegram bot.

Default: https://api.telegram.org/bot

Telegram Bot Token

Defines a password that is used to authenticate Control-M, which enables you to access and communicate with a Telegram bot.

You must create this bot in Telegram before you can add it to the connection profile.

Telegram Chat ID

Defines a unique identifier that is assigned to a specific chat conversation in Telegram, which enables you to communicate through a bot in this chat conversation.

WhatsApp URL

Determines the authentication endpoint for WhatsApp, which enables Control-M to connect to WhatsApp.

Format: https://graph.facebook.com/<Version>/<PhoneNumberId>/messages

WhatsApp Business ID

Defines the unique ID that is associated with your WhatsApp business account.

This enables Control-M to communicate over WhatsApp with customers who are connected to this account.

You must create a WhatsApp business account before you can add it to the connection profile.

Phone Number ID

Defines a unique ID that is associated with the WhatsApp user.

Recipient Phone Number

Defines the country code and phone number of the WhatsApp user.

User Access Token

Defines a password that is used to authenticate Control-M, which enables you to access your WhatsApp Business API and perform actions with this account. You can use Secrets in Code to hide this value in the code.

Version

Defines the WhatsApp API version number.

Default: v15.0

Connection Timeout

Determines the number of seconds to wait after Control-M initiates a connection request to Communication Suite before a timeout occurs.

Default: 30

Centralized

Determines whether to create a centralized connection profile, which is stored in the Control-M/EM database and is available to all Agents.

You must set this parameter to true.

Valid Values:

  • true: Creates a centralized connection profile.

  • false: Creates a local connection profile, which is associated with and stored on a specific Agent.

Default: false

ConnectionProfile:PagerDuty

PagerDuty enables you to perform incident management and response in automated workflows and job scheduling.

The following example shows how to define a PagerDuty connection profile:

Copy
{
"PAGERDUTY": {
   "Type": "ConnectionProfile:PagerDuty",
   "Pager Duty URL": "https://api.pagerduty.com",
   "API Key": "*****",
   "Connection Timeout": "50",
   "Description": "",
   "Centralized": true
}
}

The following table describes the PagerDuty connection profile parameters.

Parameter

Description

PagerDuty URL

Defines the following URL for the PageDuty API:

https://api.pagerduty.com.

Connection Timeout

Determines the number of seconds to wait after Control-M initiates a connection request to PagerDuty before a timeout occurs.

Default: 50

API Key

Defines the API key to generate in PagerDuty for the API authentication.

Centralized

Determines whether to create a centralized connection profile, which is stored in the Control-M/EM database and is available to all Agents.

You must set this parameter to true.

Valid Values:

  • true: Creates a centralized connection profile.

  • false: Creates a local connection profile, which is associated with and stored on a specific Agent.

Default: false