Alerting: Add missing fields to contact points integrations (#1060)

* add gitattributes

* add title to discord
* add title to Google chat
* add missing kafka fields:  description, details, username, password, api_version, cluster_id
* add constraints to opsGenie's send_tags_as
* pack team's URL as secret
* add missing fields to Telegram: parse_mode, disable_web_page_preview, protect_content, disable_notifications
* make threema fields optional
* add missing fields to wecom + make url optional: secret, corp_id, agent_id, msg_type, to_user

* change separators for email address to match https://github.com/grafana/alerting/blob/f5fde7b9a4b73e8687e50aedf78773981f9d7a11/receivers/email/config.go#L50-L58

* support string for webhook's maxAlerts If integration is edited via UI it will contain string that represents number
* add upload_image to popover

Author: yuri-tceretian

.gitattributes

@@ -0,0 +1 @@
+* text=auto eol=lf

docs/resources/contact_point.md

@@ -116,6 +116,7 @@ Optional:
 - `disable_resolve_message` (Boolean) Whether to disable sending resolve messages. Defaults to `false`.
 - `message` (String) The templated content of the message. Defaults to ``.
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
+- `title` (String) The templated content of the title.
 - `use_discord_username` (Boolean) Whether to use the bot account's plain username instead of "Grafana." Defaults to `false`.
 
 Read-Only:
@@ -155,6 +156,7 @@ Optional:
 - `disable_resolve_message` (Boolean) Whether to disable sending resolve messages. Defaults to `false`.
 - `message` (String) The templated content of the message.
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
+- `title` (String) The templated content of the title.
 
 Read-Only:
 
@@ -171,8 +173,14 @@ Required:
 
 Optional:
 
+- `api_version` (String) The API version to use when contacting the Kafka REST Server. Supported: v2 (default) and v3. Defaults to `v2`.
+- `cluster_id` (String) The Id of cluster to use when contacting the Kafka REST Server. Required api_version to be 'v3'
+- `description` (String) The templated description of the Kafka message.
+- `details` (String) The templated details to include with the message.
 - `disable_resolve_message` (Boolean) Whether to disable sending resolve messages. Defaults to `false`.
+- `password` (String, Sensitive) The password to use when making a call to the Kafka REST Proxy
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
+- `username` (String) The user name to use when making a call to the Kafka REST Proxy
 
 Read-Only:
 
@@ -249,6 +257,7 @@ Optional:
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
 - `sound` (String) The sound associated with the notification.
 - `title` (String) The templated title of the message.
+- `upload_image` (Boolean) Whether to send images in the notification or not. Default is true. Requires Grafana to be configured to send images in notifications.
 
 Read-Only:
 
@@ -333,8 +342,12 @@ Required:
 
 Optional:
 
+- `disable_notifications` (Boolean) When set users will receive a notification with no sound.
 - `disable_resolve_message` (Boolean) Whether to disable sending resolve messages. Defaults to `false`.
+- `disable_web_page_preview` (Boolean) When set it disables link previews for links in the message.
 - `message` (String) The templated content of the message.
+- `parse_mode` (String) Mode for parsing entities in the message text. Supported: None, Markdown, MarkdownV2, and HTML. HTML is the default.
+- `protect_content` (Boolean) When set it protects the contents of the message from forwarding and saving.
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
 
 Read-Only:
@@ -348,15 +361,15 @@ Read-Only:
 Required:
 
 - `api_secret` (String, Sensitive) The Threema API key.
-- `description` (String, Sensitive) The templated description of the message.
 - `gateway_id` (String) The Threema gateway ID.
 - `recipient_id` (String) The ID of the recipient of the message.
-- `title` (String, Sensitive) The templated title of the message.
 
 Optional:
 
+- `description` (String) The templated description of the message.
 - `disable_resolve_message` (Boolean) Whether to disable sending resolve messages. Defaults to `false`.
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
+- `title` (String) The templated title of the message.
 
 Read-Only:
 
@@ -411,16 +424,18 @@ Read-Only:
 <a id="nestedblock--wecom"></a>
 ### Nested Schema for `wecom`
 
-Required:
-
-- `url` (String, Sensitive) The WeCom webhook URL.
-
 Optional:
 
+- `agent_id` (String) Agent ID added to the request payload when using APIAPP.
+- `corp_id` (String) Corp ID used to get token when using APIAPP.
 - `disable_resolve_message` (Boolean) Whether to disable sending resolve messages. Defaults to `false`.
 - `message` (String) The templated content of the message to send.
+- `msg_type` (String) The type of them message. Supported: markdown, text. Default: text.
+- `secret` (String, Sensitive) The secret key required to obtain access token when using APIAPP. See https://work.weixin.qq.com/wework_admin/frame#apps to create APIAPP.
 - `settings` (Map of String, Sensitive) Additional custom properties to attach to the notifier. Defaults to `map[]`.
 - `title` (String) The templated title of the message to send.
+- `to_user` (String) The ID of user that should receive the message. Multiple entries should be separated by '|'. Default: @all.
+- `url` (String, Sensitive) The WeCom webhook URL. Required if using GroupRobot.
 
 Read-Only:
 

examples/resources/grafana_contact_point/_acc_receiver_types.tf

@@ -16,6 +16,7 @@ resource "grafana_contact_point" "receiver_types" {
 
   discord {
     url                     = "http://discord-url"
+    title                   = "title"
     message                 = "message"
     avatar_url              = "avatar_url"
     use_discord_username    = true
@@ -32,12 +33,19 @@ resource "grafana_contact_point" "receiver_types" {
 
   googlechat {
     url     = "http://googlechat-url"
+    title   = "title"
     message = "message"
   }
 
   kafka {
     rest_proxy_url = "http://kafka-rest-proxy-url"
     topic          = "mytopic"
+    description    = "description"
+    details        = "details"
+    username       = "username"
+    password       = "password"
+    api_version    = "v3"
+    cluster_id     = "cluster_id"
   }
 
   opsgenie {
@@ -67,17 +75,18 @@ resource "grafana_contact_point" "receiver_types" {
   }
 
   pushover {
-    user_key    = "userkey"
-    api_token   = "token"
-    priority    = 0
-    ok_priority = 0
-    retry       = 45
-    expire      = 80000
-    device      = "device"
-    sound       = "bugle"
-    ok_sound    = "cashregister"
-    title       = "title"
-    message     = "message"
+    user_key     = "userkey"
+    api_token    = "token"
+    priority     = 0
+    ok_priority  = 0
+    retry        = 45
+    expire       = 80000
+    device       = "device"
+    sound        = "bugle"
+    ok_sound     = "cashregister"
+    title        = "title"
+    message      = "message"
+    upload_image = false
   }
 
   sensugo {
@@ -112,9 +121,13 @@ resource "grafana_contact_point" "receiver_types" {
   }
 
   telegram {
-    token   = "token"
-    chat_id = "chat-id"
-    message = "message"
+    token                    = "token"
+    chat_id                  = "chat-id"
+    message                  = "message"
+    parse_mode               = "Markdown"
+    disable_web_page_preview = true
+    protect_content          = true
+    disable_notifications    = true
   }
 
   threema {
@@ -143,8 +156,13 @@ resource "grafana_contact_point" "receiver_types" {
   }
 
   wecom {
-    url     = "http://wecom-url"
-    message = "message"
-    title   = "title"
+    url      = "http://wecom-url"
+    message  = "message"
+    title    = "title"
+    secret   = "secret"
+    corp_id  = "corp_id"
+    agent_id = "agent_id"
+    msg_type = "text"
+    to_user  = "to_user"
   }
 }