Prerequisites
- You must have the Admin role in AI Helpdesk.
- You must have administrator permissions in your LINE WORKS tenant.
- You need permissions to create apps in the LINE WORKS Developer Console.
Required information for LINE WORKS connection
Create a client app and a bot in the LINE WORKS Developer Console and prepare the following information.Setup in the LINE WORKS Developer Console
Create a client app
- Open Console > Bot > Create Client App and click + Add a new app.
- Enter an app name, choose Authentication App, and submit.
-
Configure App Information as follows.
-
After submitting, record the following credentials:
- Client ID
- Client Secret
- Service Account
- Private Key (PEM)
Create a bot
- Open Console > Bot > Create new Bot.
- Enter the bot name and description.
-
Enable Callback URL and set it to:
- Enable text, image, and file on the Callback URL.
- Enable the Bot Policy checkboxes.
- After saving, open the bot’s detail screen and record the Bot ID and Bot Secret.
Add the bot to your workspace
In the LINE WORKS Admin Console, go to Service > Bot > Add Bot and add the bot you created to the workspace. Configure the policy, user rights, and privacy settings to match your workspace’s operational guidelines.Connect LINE WORKS
1
Open integration settings
Select Settings from the left navigation and open the Integrations tab.
In the Messaging section, click Add connection and choose LINE WORKS — Custom Bot.
2
Enter credentials (Step 1)
Enter all of the following information.
- Domain ID
- Client ID
- Client Secret
- Service Account (format:
serviceaccount@...) - Private Key (paste the full PEM content including line breaks)
- Bot ID
- Bot Secret
- Workspace name (optional)
3
Select an observer user (Step 2)
AI Helpdesk talk room sessions require at least three members.
In addition to the end user and the bot, select a user from the list to participate as an “observer.”Select a user and click Connect.
When credential validation succeeds, a list of users in the LINE WORKS tenant is displayed.
It is recommended to use a dedicated account that does not monitor inquiry content during normal operations.
4
Confirm successful connection
After a successful connection, a LINE WORKS card appears in the Messaging section, showing the domain ID and connected status.
Using the bot
After connecting, LINE WORKS users can send inquiries in a talk room with the bot. When a user sends a message to the bot’s talk room, a group talk is automatically created and a session begins.Disconnect LINE WORKS
In the Messaging section under Settings > Integrations, click the trash icon on the card to disconnect.Troubleshooting
“Credentials are invalid” error- Verify that the domain ID contains numbers only.
- Confirm that the private key is in the correct PEM format (full content with line breaks).
- Check that the app is enabled in the LINE WORKS Developer Console.
- Verify that the service account has the necessary scopes (such as
user.read). - Check whether the LINE WORKS API rate limit has been reached.

