# Lark Messenger

The Lark Messenger node allows you to automate work in Lark Messenger, and integrate Lark Messenger with other applications. N8N has built-in support for a wide range of Lark Messenger features, including such as: 

* Send different types of messages via Lark, such as text, rich text, images, files, interactive [message cards](https://open.larksuite.com/document/ukTMukTMukTM/uczM3QjL3MzN04yNzcDN), videos, audios, and emojis.
* Manage Lark groups, such as creating a group and adding a user or a bot to a group.

On this page, you'll find a list of operations the Lark Messenger node supports and links to more resources.

{% hint style="info" %}
**Credentials:** Refer to [Lark credentials](https://open.larksuite.com/document/server-docs/getting-started/api-access-token/auth-v3/tenant_access_token_internal) for guidance on setting up authentication.
{% endhint %}

## Basic Operations 

* Message management
  * Send message
  * Reply message
  * Edit Message
  * Recall message
  * Forward a message
  * Merge forward messages
  * Query the read status of message
  * Get chat history
  * Obtain resource files in messages
  * Obtain the content of the specified message
* Buzz message
  * Send buzz messages in apps
* Batch message
  * Send messages in batches
  * Recall messages in batches
  * Query the number of pushers and readers of batch messages
  * Query the overall progress of a batch message
* Message reaction
  * Add a reaction for a message 
  * Delete a reaction for a message
  * List message reactions
* Pin
  * Pin a message
  * Unpin a message
  * Get pins in group

## Example Usage

This workflow enables you to send a message to a designated recipient. This example usage workflow would use the following nodes. - [Start](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.start/) – Lark Authentication – Lark Messenger.

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

1\.    Start node

The start node exists by default when you create a new workflow.

2\.    Lark Authentication node

We will use the Lark Authentication node to get the values of the tenant access token.

* Click on the *Add node or drag to connect* button and enter *Lark Authentication* in the search nodes box.
* Select *Create New Credential* from the dropdown list.
* Enter your app ID in the *App ID* field.
* Enter your app secret in the *App Secret* field.
* Click on *Save* to save credentials.
* Turn off the popup and click on *Execute Node* to run a node.

<figure><img src="/files/pBhTas14xutRiFvCmNKk" alt=""><figcaption><p>In this screenshot, you will notice that the node sets the value for create new credential.</p></figcaption></figure>

<figure><img src="/files/LzT4sjSiYZOa44CnEtva" alt=""><figcaption><p>In this screenshot, you will notice that the node sets the value for App ID and App Secret.</p></figcaption></figure>

<figure><img src="/files/kVV7xeqDZ0Jmy500Fbv0" alt=""><figcaption><p>After executing Lark Authentication node</p></figcaption></figure>

3. Lark Messenger node (Append)

We will use the send message and card action in the Lark Messenger node to set the values for needed fields.

* Click on the Add node or drag to connect button and enter Lark Messenger in the search nodes box.
* Search send message and card in search Lark Messenger Actions box.
* Enter your tenant access token in the *Tenant Access Token* field.
* Enter your app token in the *App Token* field.
* Enter your Receive ID Type in the *Receive ID Type* field.
* Enter your Receive ID in the *Receive ID* field.
* Select the type of message(text or interactive) from the *Message Type* dropdown list.
  * Select text type

<figure><img src="/files/Fdh77dRuPLZleUr2JKF6" alt=""><figcaption><p>In this screenshot, you will notice that the node sets the value for needed fields.</p></figcaption></figure>

<figure><img src="/files/CCLcFsm3OSueIIuuQLRV" alt=""><figcaption><p>In this screenshot, you will notice that the result of execute node.</p></figcaption></figure>

* Select interactive type

<figure><img src="/files/GAaE8hZ2goIzY5eqeyGl" alt=""><figcaption><p>In the screenshot below, you will notice the template of the card builder(link: <a href="https://open.larksuite.com/tool/cardbuilder?templateId=ctp_AAmo2YZwEydW">Card Builder - Lark Developer (larksuite.com)</a>). You will copy the highlight part.</p></figcaption></figure>

<figure><img src="/files/tUgp1Rc2D8u5DBekrXaa" alt=""><figcaption><p>In this screenshot, you will notice that the node sets the value for needed fields. The value of the message card field is the content copied in the step above.</p></figcaption></figure>

<figure><img src="/files/P3uoFaKScMyC8g9L6ANo" alt=""><figcaption><p>In this screenshot, you see result after run node.</p></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-messenger.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.