Updated: October 10, 2024

How to Connect the Enji.ai Bot in Chatwork

These instructions guide users to create and register the stand-up bot in Chatwork for quick and easy stand-up submission.

Bots, Standups and Alerting

General information

One bot account is created for each workspace. This is a technical user that needs to be added to the channel just like regular users. Separate webhooks are created for submitting and editing stand-ups in the bot account.

Creating a Chatwork channel

If there is no channel in Chatwork, one will need to be created:

  1. Create a channel.
  2. Configure the channel name, add participants, specify their roles, and set admin access to the channel (if necessary).

Registering a Chatwork channel in Enji

  1. First, find the name and ID of the channel.
  2. Go to Enji Settings -> Team Channels page. Create a new channel and enter the data for the Chatwork channel.

Registering a Chatwork account in Enji

1. Find the ID and name of the Chatwork account:

  • In Chatwork, go to account settings and open Preferences (Screenshot 1a).
  • Copy the ID of the Chatwork account (Screenshot 1b).
  • Close Preferences, go to Chatwork account profile. Copy the account name (Screenshot 1c).

2. Go to Enji Settings -> Chat Users page. Create a new user and enter the Chatwork account data.

Screenshot 1a

Linking a Chatwork channel and Enji project

Go to the settings of the Enji project and link the Chatwork channel to it.

Adding the Enji bot to the Chatwork channel

  1. Go to Chatwork and open the channel settings.
  2. Copy the channel's link.
  3. In a new browser window, log in to the Chatwork account of the Enji bot.
  • After logging in as the Enji bot, follow the invite link to the Chatwork channel (Screenshot 2a).
  • Join the channel (Screenshot 2b).

Configuring webhooks for the Enji bot

To configure webhooks:

1. Go to Integrations

2. Open the Webhook tab

There are 2 types of webhooks: Account and Room.

  • Account: A global webhook for the entire workspace. Responsible for receiving standups. It needs to be created once.
  • Room: A local webhook for an individual channel. Responsible for updating standups. It needs to be created separately for each channel.

Since only one bot account is created for one workspace, all webhooks for the workspace are stored in one place. Specifically, if there are multiple projects in the workspace, webhooks for all projects will be in one bot account.

3. If there is no Account event webhook, create a new one. Click Create New. A new page will open (Screenshot 4). Enter:

4. Create a new Room event webhook for the channel. Click Create New. A new page will open. Enter:

  • the name of the webhook (description of what it does).
  • its URL – request the actual URL from a manager.
  • select Room event.
  • click the Message Created and Message Updated checkboxes.
  • enter the ID of your channel.
  • click the Create button.

After that, the bot is ready to receive, track, and react to stand-ups from members of the channel registered in Enji. Register participants by following the instructions in the Registering a Chatwork Account in the Enji section above.

Stand-up submission process

Create and submit a stand-up by following these steps:

  1. Add the Enji bot to contacts.
  2. Specify the bot as the recipient of a message (standup).
  3. Write about the previous day's activities and plans for the current day, and report problems/good things. Find an example of a stand-up in screenshot 3.
  4. The stand-up is accepted when the bot sends a private message with the text "Thanks for the stand-up!"

If the bot did not send an acceptance message and/or sent an error notification, contact a manager.

Editing a stand-up

To make changes to a submitted stand-up:

  1. Hover over the stand-up and click the Edit button.
  2. Make the necessary changes and save them.
  3. The bot should send a private message with the text "Stand-up has been updated."

If the bot did not send an acceptance message and/or sent an error notification, contact a manager.