stevehuang0115/crewly/attach-file

Attach File

reply-channel sends text. This sends a file, into the same Slack thread, from the same bot as your words.

bash execute.sh --channel <chatChannelId> --path /tmp/report.pdf
bash execute.sh --channel <chatChannelId> --path /tmp/report.pdf \
  --comment "方案 v2，第 3 节改了" --thread <messageId>

--channel is the chat channel id you were given in your prompt — the same one you pass to reply-channel. You do not need a Slack channel id; the backend resolves the Slack channel, the thread and your bot identity from it.

Parameters

When to use it

Whenever the person asks for a file. "发给我", "send me the PDF", "attach it".

Do not upload to Drive and paste a link instead. A link is not what was asked for: it makes the reader leave Slack, it breaks for anyone without access to that Drive, and on a phone it is several taps to something they wanted in front of them. Send the file; add a Drive link as well only if they will want to edit it.

Text still goes through reply-channel — send the words, attach the file.

Put --comment in single quotes (or leave quotation marks out of it): a double quote inside --comment "..." splits the text into extra arguments and the file is not sent. Read the JSON result; do not cut it off with | tail -1. The file is also recorded in the chat history under your name, so teammates reading the thread see you delivered it.

Output

{"success":true,"data":{"slackChannelId":"C…","threadTs":"1758…","fileId":"F…","asAgentBot":true}}

asAgentBot:false means your own Slack bot is not installed yet, so the file arrived from the workspace app instead of from you. It still lands; mention it to the owner if they ask why the name differs.

Failures

{"success":false,"code":"thread_unresolved","error":"File NOT sent: …"} — Crewly could not tell which thread the file answers. The file is never posted at the channel's top level instead: run it again with --work-item <id> (from your [CREWLY-DISPATCH]), --to <message id> or --ticket <id>.

{"success":false,"error":"not_a_slack_channel"} — that chat channel is not mirrored to Slack. Nothing to attach to; reply with text.

{"success":false,"error":"No such file: …"} — check the path. Write the file out first, then attach it.

{"success":false,"error":"slack_not_connected"} — Slack is down for this instance. Say so; do not fall back to a link without saying why.