# Lark Custom Bot

## Overview

### Plain Text

The Send Plain Text skill of the Lark Customs Bot brings simplicity and effectiveness to the forefront of customs communication. This skill allows the bot to transmit crucial customs information, updates, and responses through plain text messages that are easy to read and understand.

Whether it is answering queries, providing real-time updates on customs processes, or guiding users step by step through customs procedures, the plain text messages delivered are crafted to convey information clearly and concisely. This feature ensures that users receive the vital information they need without any fluff, promoting a straightforward and efficient communication pathway.

**Applications**

* **Instant Notifications**: Receive quick notifications regarding customs updates directly to your preferred messaging platform.
* **Simple Query Responses**: Get your customs queries answered in simple, unambiguous, and clear text.
* **Guided Assistance**: Experience guided assistance through complex customs processes with clear instructions sent in plain text.

**Benefits**

* **User-Friendly**: Plain text messages are simple and easy to read, offering a user-friendly experience.
* **Cross-Platform Compatibility**: Plain text messages can be accessed on a variety of devices and platforms without any compatibility issues.
* **Quick Communication**: Enables rapid dissemination of important information without any delays.

### Message Card

The Message Card skill of the Lark Customs Bot takes user engagement to a new level by offering interactive message cards that contain rich content and actionable items. These cards can be customized to carry a range of information including texts, images, links, and buttons, providing a more dynamic and interactive user experience.

Through message cards, users can not only receive information but also take actions such as filling out forms, navigating to different resources, or initiating workflows, all within the messaging environment. This skill brings a nuanced approach to customs communication, where information is paired with actionable steps, enhancing user engagement and facilitating smoother customs processes.

**Applications**

* **Interactive Forms**: Utilize message cards to fill out customs forms interactively, with guided prompts and help texts.
* **Resource Navigation**: Navigate easily to different resources and information hubs through links embedded in message cards.
* **Visual Content**: Benefit from visual content like infographics and images that provide a rich context and assist in understanding complex customs processes.

**Benefits**

* **Interactive Engagement**: Message cards offer an interactive medium for users to engage with the customs bot, facilitating active participation.
* **Rich Content Display**: Display a rich array of content types, enhancing the user experience through dynamic information presentation.
* **Actionable Steps**: Enable users to take actions directly from the message cards, streamlining various customs processes through integrated workflows.

## Basic nodes

* Send Plain Text
* Send Message Card

## Example Usage

First of all, you must add the customs bot to your group 

#### Step 1:  Click on the icon bot

<figure><img src="/files/0B80McglWQqNFNHvTPax" alt=""><figcaption><p>Click on the icon bot</p></figcaption></figure>

#### Step 2: Click on the Add bot

When you click on the icon bot in the [step 1](https://app.gitbook.com/o/iYB4Gq7E4A5Saq9gnovN/s/bKSyz9raClfug01cr4Yb/~/changes/12/lark-customs-bot#step-1-click-on-the-icon-bot) you will see the toolbar like this pictures then you click on the Add bot to add the bot to the group chat

<figure><img src="/files/gHVPnTc8PqOydLsK0PO3" alt=""><figcaption></figcaption></figure>

#### Step 3 : Click on the custom bot card

a When you click to add bot it will display the table list of the app you want to add, click on Custom Bot to add the custom bot

<figure><img src="/files/Kgy1twbr2SJyXgFOKyA5" alt=""><figcaption></figcaption></figure>

#### Step 4: Edit your Bot name,  description bot, and Avatar of the bot

When you click on the custom bot it shows the detail of the bot you can edit then click add to add the bot to your group chat&#x20;

<figure><img src="/files/4yWWfjc9Se1iE4QTk1pf" alt=""><figcaption></figcaption></figure>

#### Step 5: Copy the Webhook URL&#x20;

when you add the custom bot it shows the Webhook URL then you copy the Webhook to control the bot. then you click Finish to finish step 5

<figure><img src="/files/AGRLvyJc1ek7dxcRYw9S" alt=""><figcaption></figcaption></figure>

#### Step 6:  Be sure to keep your webhook URL secure

if you want to customize the webhook URL you can learn more at [Lark Bot Customize](https://open.larksuite.com/document/client-docs/bot-v3/bot-overview) or you enter the Maybe Later Button to finish.

<figure><img src="/files/aeWvbhyXbJMD7T0GSiV8" alt=""><figcaption></figcaption></figure>

This is a guide to setting up the custom bot, we will start to send plain text in n8n.

\ <br>

### Send Plain Text

First, you search the keyword: Lark Custom Bot you will see the node Lark Custom Bot.

<figure><img src="/files/dqNgCXlBB13XpCQU3bNT" alt=""><figcaption></figcaption></figure>

<br>

#### Step 1: Click on  Send Plain Text

When you click on the Node Custom Bot, It shows the sidebar then you click on the Send Plain Text to send plain text.

<figure><img src="/files/GvAO43P45ntmWTSWfaRQ" alt=""><figcaption></figcaption></figure>

#### Step 2: Enter your content and Link the webhook

Enter the link Webhook in the [step copy before](https://app.gitbook.com/o/iYB4Gq7E4A5Saq9gnovN/s/bKSyz9raClfug01cr4Yb/~/changes/12/lark-customs-bot#step-5-copy-the-webhook-url), then you enter the content you want to control bot give

<figure><img src="/files/ZtIAqQRoRSJojqu7WZX1" alt=""><figcaption></figcaption></figure>

#### Step 3: Execute node

When you fill the webhook and plain text fields then you click execute node to give to the group this is also a finished task in the send plain text.

<figure><img src="/files/wOJKgLZrSVfOt1nZsaOZ" alt=""><figcaption><p><br></p></figcaption></figure>

#### Exception : &#x20;

If before this node has data about the text but you want to paste it to this node let's do like bellow :&#x20;

<figure><img src="/files/7zrC3a5Uh7zgipUVJtgV" alt=""><figcaption></figcaption></figure>

## Send Message Card

First, you also search the keyword: Lark Custom Bot you will see the node Lark Custom Bot.

<figure><img src="/files/W5rs3IOH2BUJdQ40f0Zk" alt=""><figcaption></figcaption></figure>

#### Step 1: Click on the send message card.

When you click on the Node Custom Bot, It shows the sidebar then you click on Send Message Card to send a Card Message.

<figure><img src="/files/Aofi44RYPxhZ80lGx721" alt=""><figcaption></figcaption></figure>

#### Step 2: Enter the webhook link and Message Card from Lark

when you click on the send message card you will see 2 fields below first you also enter the [webhook link](https://app.gitbook.com/o/iYB4Gq7E4A5Saq9gnovN/s/bKSyz9raClfug01cr4Yb/~/changes/12/lark-customs-bot#step-5-copy-the-webhook-url) then enter the message card from lark.

<figure><img src="/files/VdLwZLoOWkEKKuqFgobz" alt=""><figcaption></figcaption></figure>

#### Step 3: Get a Message Card From the Card Builder of Lark

You click [here](https://open.larksuite.com/tool/cardbuilder) to go to the card builder of Lark. Then you build the message card you want. How you build a good message card Learn more at [Lark Builder Card](https://open.larksuite.com/document/tools-and-resources/message-card-builder)

<figure><img src="/files/POrIfRNgcyVC0q7vXZ8W" alt=""><figcaption></figcaption></figure>

#### Step 4: Click on the icon code to get the JSON of the Message Card

When you built a satisfactory card, you click on the icon code in the picture below&#x20;

<figure><img src="/files/QXlDWJ3SOpWUAhWrjZmN" alt=""><figcaption></figcaption></figure>

#### Step 5: Click on the copy icon to copy the JSON message card.

When you click on the code icon you will see the picture formally like the picture below then you click on the copy icon to copy all JSON message cards then you paste on the field Message card in [step 2](https://app.gitbook.com/o/iYB4Gq7E4A5Saq9gnovN/s/bKSyz9raClfug01cr4Yb/~/changes/12/lark-customs-bot#step-2-enter-the-webhook-link-and-message-card-from-lark)&#x20;

<figure><img src="/files/yszluOOU86ouQti6EQsq" alt=""><figcaption></figcaption></figure>

#### Exception&#x20;

If you want to edit the card message from the before data node you can do like the pictures below or somewhere you want to change the message text.\
Note: Don't change the variable of the JSON, just change the value of the variable. \
&#x20;

<figure><img src="/files/1iAKszy8L2cLxq33pgVk" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs-tech.n8n.vn/lark-custom-bot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.