Overview

This guide will help you integrate 3Chat AI Customer Service with Feishu Bot, allowing your Feishu partners (including external customers) to interact with the 3Chat AI Customer Service through group chatting @bot or one-on-one chat, initiating pre-sales or after-sales inquiries.

If you are not yet a 3Chat user, please go to 3Chat to create an account, and you will receive a 7-day free trial benefit. If you develop a strong interest in our features during the trial period and subscribe to the Growth Plan, you will enjoy the best functional experience.

Quick Operation Guide

After logging into 3Chat, you can configure Feishu Bot through the following path: Channel > IM > Feishu Bot

Preparation Before Installation

Before starting, please ensure:

✅ The company must complete the corporate legal person certification or the certified letter with an official seal (team certification is not supported)

✅ You are a Feishu corporate administrator (or have administrator privileges)

✅ Have registered on the 3Chat official website and completed the Feishu corporate binding or installed and activated the 3Chat space through the Feishu Application Center

✅ Have opened and logged in toFeishu Open Platform

✅ Ensure one Feishu application is only connected to one 3Chat space

Operation Steps

Create a Corporate Self-built Application in Feishu

1. Create Application

Enter Feishu Open Platform → Developer Background, switch to the corporate self-built application tab.

Click “Create Corporate Self-built Application”, fill in the application name (e.g., 3Chat Intelligent Customer Service), application description, and upload the application icon.

1. Configure Bot Capabilities in the Application

Go to the application management page, click “Add Application Capability” in the left navigation, find “Bot” in adding by capability, and click “Add”.

On the bot page, you can customize the usage description and custom menu items of the bot according to your needs.

In the left navigation, click “Permission Management”, and after entering the page, click “Grant Permissions” to add necessary permissions.

Or click “Batch Import/Export Permissions”, copy the JSON code below into the import window, replacing the initial sample code. Complete the opening of permissions.

{
    "scopes": {
      "tenant": [
          "im:message",
          "im:message.group_at_msg:readonly",
          "im:message.p2p_msg:readonly",
          "im:message:send_as_bot",
          "cardkit:card:write",
          "contact:contact.base:readonly",
          "contact:user.base:readonly",
          "im:chat:readonly"
       ]

Here is a list of all associated permissions; you must enable permissions marked as “Critical”, otherwise it will affect the performance of 3Chat Intelligent Customer Service.

After completing the operations, the list will display the added permission information.

Configure Event Subscription

1. Get the App ID and App Secret of the application

On the application management page, click the left navigation “Credentials and Basic Information”, and in the right application credentials, get the application's App ID and App Secret.

1. Configure application information in 3Chat

Log into your 3Chat account via Feishu Workbench or 3Chat login page, and enter the Feishu Bot guide page from the left navigation bar, filling in the application's App ID and App Secret obtained in the previous step. After confirming the input is correct, click “Activate Channel” below.

If the application information is filled in correctly, the connection with the Feishu Bot is successfully completed on the 3Chat side.

1. Confirm the connection and subscription events in Feishu management background

Return to the management page of the Feishu application, click the left navigation “Events and Callbacks”, select the Event Configuration → Subscription Method as the long connection recommended by Feishu, click “Save”, after saving successfully, the long connection establishment with the 3Chat space will be completed on the Feishu side.

Click the “Added Events” button at the top right of the list to complete the subscription of necessary events.

This lists all the events that need to be subscribed to, and the events marked as “Critical” must be subscribed, otherwise it will affect the performance of 3Chat Intelligent Customer Service.

After completing the above operations, you can see the added event information in the subscribed event list.

1. Configure Callbacks

On the right side of the event configuration tab, find the “Callback Configuration”, click and switch to the callback configuration page.

Similarly, set the subscription method to the long connection recommended by Feishu, and click “Save”.

Click the button “Add Callback” at the top right of the Subscribed Callback List, search and check “Card Passback Interaction” in the card classification, and then click “Confirm Add”.

Release Application in Feishu

1. Create Version and Submit for Review

Click “Version Management and Release” in the left navigation, then click “Create Version” at the top right of the version list.

Enter the version creation page, fill in the version number, update notes, and other basic information. Confirm whether the permission configuration is correct.

In the available range, choose the corporate members who can use the bot.

The most important step, in the configuration of the available range, check “Allow the bot to be added to external groups for use, external users can open one-on-one chat with the bot after authorization”.

Finally, click “Save”, then perform “Apply for Online Release”. Once the administrator completes the review, you can share the bot with external users or join group chats to answer customer inquiries.

Frequently Asked Questions

❓ Bot cannot receive messages?

→ Check if the event subscription is configured correctly.

→ Ensure 3Chat backend connection status is normal.

❓ External customers cannot @bot?

→ Check group chat permissions (external members must be allowed to @bot).

❓ Message cards do not display?

→ Check permissions (cardkit:card:write must be enabled).

Further Support

If you need help, please contact:

📧 3Chat Customer Support: contact@3chatai.com

📞 Feishu Technical Support: search “Feishu Service Desk” within Feishu.

Finally

✅ Congratulations! You have successfully integrated 3Chat Intelligent Customer Service with Feishu Bot!

Now, your customers can interact directly with 3Chat through Feishu group chats or one-on-one chats, enhancing customer service efficiency! 🚀