WeCom Live Feed and Event Monitoring

The live feed shows incoming WeCom webhook events in real time — directly on the WeCom page, without manual refreshing.

Opening the live feed

1. Open WeCom from the sidebar.
2. The Live feed panel appears at the top of the page.
3. The connection status is shown as a badge:
   • 🟢 Connected — events are being received
   • 🔴 Disconnected — no connection, auto-reconnect in progress

Filtering events

The live feed panel has an event type dropdown. Select:

• All — every incoming event is shown
• A specific type (e.g. text_message, event) — only matching events appear

Options are populated automatically from received events.

Auto-reconnect

If the connection drops (e.g. due to network issues), the feed reconnects automatically after 5 seconds. The badge reflects the current status.

Event table (historical)

Below the live feed, the table shows the last 30 events from the database. Click a row or the XML button to view the full XML in the side panel.

Testing the connection

Send a test event from the WeCom console:

1. Open your WeCom app configuration.
2. Use the "Verify" function or send a test message.
3. Watch the live feed panel — the event should appear within seconds.

If no event appears:

• Check the connection badge (must be green).
• Verify the callback URL is correctly configured (see Set up WeCom callback).
• Check the IP allowlist (see WeCom IP allowlist setup).

Technical background

The live feed uses Server-Sent Events (SSE) via GET /api/wecom/events/stream. The server sends the last 10 historical events on connect, then checks for new events every 5 seconds. The browser keeps the connection open — no polling needed.