Connect ChatWork to Cogno

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 User 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 are a Cogno workspace owner.
• 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 Cogno app.
2. Open Integrations in the target workspace.
3. Select ChatWork.
4. Click Connect ChatWork.
5. Review and approve the scopes on the ChatWork authorization screen.
6. Return to the ChatWork integration page in Cogno and confirm that Connection 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. Open Integrations > ChatWork in Cogno.
2. Copy the Webhook URL from Webhook setup. This section is visible only to workspace owners.
3. Create a new webhook from ChatWork API management.
4. Paste Cogno's Webhook URL into the ChatWork webhook URL field.
5. Select the events Cogno should ingest. Cogno ingests message_created, message_updated, and mention_to_me.
6. 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. Open the edit screen for the ChatWork webhook you created.
2. Find the Webhook Setting ID and Webhook Token.
3. Return to Webhook setup in Cogno.
4. Enter the Webhook Setting ID and Webhook Token.
5. Click Save webhook.
6. Confirm that 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 User mapping

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

1. Click Sync users to refresh candidates.
2. Map each ChatWork account to the matching Cogno workspace member.
3. Keep the mapping accurate so ChatWork mentions and authors are resolved to workspace members before semantic events are created.

Cogno also uses the same mapping in reverse when it needs to mention a ChatWork account. Fix User mapping first when a ChatWork account points to the wrong Cogno member.

Common states

Reference URLs

• ChatWork OAuth 2.0 documentation
• ChatWork Webhook documentation

Related docs

• Troubleshooting