Messaging and Communication Connection Profiles

The following topics describe the connection profile parameters for messaging and communication platforms and services.

Communication Suite Connection Profile Parameters

Before you can define a job, you must create a connection profile in the Configuration domain. A connection profile contains authorization credentials—such as the username, password, and other plug-in-specific parameters—and enables you to connect to the application server with only the connection profile name. To create a connection profile, see Creating a Centralized Connection Profile.

For more information about this plug-in, see Control-M Communication Suite.

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, as described in Creating Incoming Webhooks, before you can add it to the connection profile.

https://x3dmj.webhook.office.com/webhookb2/5db2b288-138d-428d-ade7-478f727d93f3@edc0deae-5fde-4a7f-ac1e-91cb80a6526e/IncomingWebhook/ba207b318894421d9ede7c9ad1251141/05f0a54e-cec1-4df4-893b-8e61d684516a

Slack Webhook URL

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

You must create this webhook in Slack, as described in Sending Messages Using Incoming Webhooks, before you can add it to the connection profile.

httpsf2://hooks.slack.com/services/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

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, as described in Creating a Bot, 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.

207397578157

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, as described in Get Started with Cloud API, before you can add it to the connection profile.

142913904062636

Phone Number ID

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

790951673835859

Recipient Phone Number

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

17185551212

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.

Version

Defines the WhatsApp API version number.

Default: v15.0

Use External Vault

Determines whether to locate and retrieve a secret from an external vault, as described in CyberArk Secret Parameters in Connection Profiles.

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

PagerDuty Connection Profile Parameters

Before you can define a job, you must create a connection profile in the Configuration domain. A connection profile contains authorization credentials—such as the username, password, and other plug-in-specific parameters—and enables you to connect to the application server with only the connection profile name. To create a connection profile, see Creating a Centralized Connection Profile.

For more information about this plug-in, see Control-M PagerDuty.

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.

API Key

Defines the API key that you generate in PagerDuty to authenticate API requests.

Use External Vault

Determines whether to locate and retrieve a secret from an external vault, as described in CyberArk Secret Parameters in Connection Profiles.

Connection Timeout

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

Default: 50