Lark

Send notifications to Lark using a custom bot webhook.

URL Format

lark://host/token?secret=secret&title=title&link=url

URL Fields

• Host - Custom bot URL Host
  Default: open.larksuite.com
  URL part: lark://host/path/
• Path - Custom bot token (Required)
  URL part: lark://host/path/

Query/Param Props

Props can be either supplied using the params argument, or through the URL using
?key=value&key=value etc.

• Link - Optional link URL
  Default: empty

• Secret - Custom bot secret
  Default: empty

• Title - Message Title
  Default: empty

• host: The bot API host (open.larksuite.com for Lark, open.feishu.cn for Feishu).

• token: The bot webhook token (required).
• secret: Optional bot secret for signed requests.
• title: Optional message title (switches to post format if set).
• link: Optional URL to include as a clickable link in the message.

Example URL

lark://open.larksuite.com/abc123?secret=xyz789&title=Alert&link=https://example.com

Create a Custom Bot in Lark

Official Documentation: Custom Bot Guide

1. Invite the Custom Bot to a Group:
   a. Open the target group, click More in the upper-right corner, and then select Settings.
   b. In the Settings panel, click Group Bot.
   c. Click Add a Bot under Group Bot.
   d. In the Add Bot dialog, locate Custom Bot and select it.
   e. Set the bot’s name and description, then click Add.
   f. Copy the webhook address and click Finish.

2. Get Host and Token:

3. For Lark: Use host = open.larksuite.com.
4. For Feishu: Use host = open.feishu.cn.

5. The token is the last segment of the webhook URL.
   For example, in https://open.larksuite.com/open-apis/bot/v2/hook/xxxxxxxxxxxxxxxxx, the token is xxxxxxxxxxxxxxxxx.

6. Get Secret (Optional):
   a. In group settings, open the bot list, find your custom bot, and select it to access its configuration.
   b. Under Security Settings, enable Signature Verification.
   c. Click Copy to save the secret.
   d. Click Save to apply the changes.