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.| Field | Where to obtain |
|---|---|
| Domain ID | Domain ID shown on the home page of the LINE WORKS Developer Console (numeric) |
| Client ID | Client app’s App Information |
| Client Secret | Client app’s App Information |
| Service Account | Client app’s App Information (format: serviceaccount@...) |
| Private Key | Client app’s App Information (RSA private key in PEM format) |
| Bot ID | Bot ID (numeric) registered in LINE WORKS Developers |
| Bot Secret | Bot secret |
| Workspace name (optional) | Display name in AI Helpdesk |
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.
Setting Value App access permissions All members Access Token expiration date 1 hour Refresh Token Rotation On OAuth Scopes bot,bot.message,bot.read,user.read -
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
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.
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)
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.
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.