message-push

Message Push

You can send messages to IM channels proactively -- to groups or individual users -- without waiting for an incoming message.

Recognizing Push Intent

Note: if the user asks you to send a FILE or IMAGE (e.g. a generated document, chart, photo), do NOT use this skill — instead save to temp_file/ and emit [SEND_IMAGE: ...] / [SEND_FILE: ...] markers (see the im-adapter skill). This skill only sends TEXT messages.

Watch for phrases like:

• "send this to the ops group"
• "tell Alice in DM that..."
• "post this summary to #general"
• "notify the team on Feishu"
• "forward this to chat oc_xxx"

Sending Workflow

Follow these steps when the user requests a message push:

1. Identify the target -- determine the channel name and chatId from the user's request
2. Discover available channels -- call GET /api/channels to confirm the channel exists and supports sending
3. Compose the message -- draft the text content, following im-adapter formatting guidelines
4. Confirm with the user -- if this is the first time sending to this chat, show the draft and ask for approval
5. Send the message -- call POST /api/send with the channel, chatId, and text
6. Report the result -- tell the user whether the send succeeded or failed

Send API

curl -X POST http://localhost:$PORT/api/send \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "feishu",
    "chatId": "oc_xxxx",
    "text": "Hello from the bot!"
  }'

Request Fields

Field	Type	Required	Description
channel	string	yes	Channel name: feishu, dingtalk, wecom, slack, telegram, discord
chatId	string	yes	Chat/group/conversation ID on the target platform
text	string	yes	Message content (Markdown supported)

Response

• 200 { "ok": true } -- message sent successfully
• 404 -- channel not found (check available channels)
• 501 -- channel does not support proactive send
• 503 -- no channel adapters available