What is a Connector

Connectors allow Custom Actions and Automations to send alerts via third-party technology. (Azure Service Bus, Email, SMS, Microsoft Teams, Service Now)

Creating a New Connector

1. Click the Settings cog 
2. Click Connectors 
3. Click the Add button (blue plus sign) in the top right corner 
4. Select the connector type.
    

Azure Service Bus

1. Enter a name. It’s better if it’s unique but doesn’t have to be. 
2. Dropdown menu for Service Bus type (Queue/Topic). For more information on Topics versus Queues, see Microsoft's Documentation on Service Busses. 
3. Enter the Primary Connection string for the SAS Policy you wish to use. 
4. The name of the topic or queue you wish to use.
    

Email List

1. Enter a name. It’s better if it’s unique but doesn’t have to be. 
2. Enter email recipients. One email address on each line. Email addresses are not checked for validity.
   

SMS List

1. Enter a name. It’s better if it’s unique but doesn’t have to be. 
2. Enter mobile phone numbers for recipients. One mobile phone number on each line. Phone numbers aren’t checked for validity – length, international direct dialling codes.
    

Microsoft Teams

1. Go to Microsoft Teams. Find the channel you would like Canopy to message. 
2. Hover on that channel to see the 3 dots button.
3. Click Connections.
    
4. Find “Incoming Webhook” (or search for it) and click Configure.
    
5. Enter a name for the Connector that will appear in Teams and click Create.
   
6. After you click Create, you’ll be given a webhook URL. Copy it to the clipboard (and a note just in case), then click Done.
    
7. Go back to Canopy and create a Teams connector, entering a unique name. 
8. Paste the webhook URL from step 6.
   

Service Now

1. Enter an appropriate name for the connector. Making it unique will be easier to find later. 
2. Enter your ServiceNow server address. 
3. Enter the username with appropriate access to ServiceNow. 
4. Enter the password for the above account.