Skip to main content
ChatWork
Beta. This integration is available, but how accurately Cogno extracts tasks and context from these messages has not been validated yet. Expect rough edges, and tell us what you see.

At a glance

ChatWork uses two setup steps in Cogno: OAuth connection and webhook setup. OAuth connection authorizes Cogno to read the ChatWork API. Cogno uses the rooms, messages, and members visible to the authorized ChatWork user to keep the integration connected and build Member mapping candidates. Webhook setup sends ChatWork message events to Cogno in real time. You register Cogno’s Webhook URL in ChatWork, then save the Webhook Setting ID and Webhook Token in Cogno.

Before you start

  • You have the Manage integrations permission in the target Cogno workspace.
  • You can use a ChatWork account that participates in the target rooms.
  • You can create and edit webhooks from ChatWork API management.
  • For a team-wide integration, use a ChatWork operator account that will not disappear when an individual user leaves or changes permissions.

Connect OAuth in Cogno

1

Open the ChatWork integration

Open Integrations in the target workspace and find ChatWork.
2

Authorize ChatWork

Click Connect, then review and approve the scopes on the ChatWork authorization screen.
3

Confirm the connection

Back in Cogno, the Connection section shows Connected.
Cogno can read the ChatWork API after this step. To receive live message events, complete the webhook setup as well.

Create the webhook in ChatWork

1

Copy Cogno's Webhook URL

On the ChatWork page in Cogno, copy the Webhook URL from Webhook setup. This section is visible only to members with the Manage integrations permission — the Setup guide link there opens ChatWork’s own instructions.
2

Create the webhook in ChatWork

Create a new webhook from ChatWork API management and paste Cogno’s Webhook URL into the ChatWork webhook URL field.
3

Select the events

Select the events Cogno should ingest — Cogno ingests message_created, message_updated, and mention_to_me — then save the webhook in ChatWork.
ChatWork webhooks are real-time notifications configured from ChatWork API management. See ChatWork Webhook documentation for the provider details.

Save webhook verification values in Cogno

1

Find the values in ChatWork

Open the edit screen for the ChatWork webhook you created and find the Webhook Setting ID and Webhook Token.
2

Save them in Cogno

Back in Webhook setup, enter the Webhook Setting ID and Webhook Token, then click Save webhook.
3

Confirm the status

The status changes to Webhook configured.
Cogno uses this ID and token to verify that inbound webhooks belong to the expected ChatWork setting for the workspace.

Review member mapping

When Cogno finds ChatWork account candidates from the webhook or ChatWork API, they appear under Member mapping.
1

Sync candidates

Choose Sync members to refresh candidates.
2

Map each account

Map each ChatWork account to the matching Cogno workspace member.
Keep the mapping accurate so ChatWork mentions and authors resolve to the right workspace members. Cogno also uses the same mapping in reverse when it needs to mention a ChatWork account. Fix Member mapping first when a ChatWork account points to the wrong Cogno member.

Disconnect

Open the menu on the connection row and choose Disconnect, then confirm.

Common states

Reference URLs