# Configure a WeCom group robot

A group robot uses the Webhook URL belonging to one WeCom group. After binding, an agent can send messages to that group.

## Create message push in the group

Open the target group's chat information and select **Message push**. Add a custom message push, give it a name such as “MOI project notifications,” copy the generated **Webhook URL**, and save.

## Create the MOI instance

1. Open **Resource Center → Tools → WeCom → Add → Group robot**.
2. Enter an instance name.
3. In **Webhook Key**, paste either the complete Webhook URL or only the value after `key=` in that URL.
4. Leave the optional timeout empty for the 30-second default, or set it as needed.
5. Save and run the connection test. **This test sends a connection-test message to the WeCom group.**

The saved instance hides the Webhook Key. Verify the destination and test result rather than expecting the key to remain visible.

## Validate and troubleshoot

Bind the saved instance to the target agent and request an explicit test message. Confirm its receipt in the intended group.

| Symptom | Check first | Next action |
| --- | --- | --- |
| Message push unavailable | Group settings and member permissions | Ask the group owner or enterprise administrator to confirm creation permissions |
| Connection test fails | Complete Webhook URL or key value | Copy it again and update Webhook Key |
| Saved but no message appears | The test targeted the newly configured instance | Run its connection test or request a text message through the agent |

- [WeCom configuration](../wecom.md)