Skip to content

docs(signal): clarify Signal channel is an inbound inbox, not a self-text channel#359

Open
MatthewSuttles wants to merge 1 commit into
mainfrom
docs/signal-inbox-expectations
Open

docs(signal): clarify Signal channel is an inbound inbox, not a self-text channel#359
MatthewSuttles wants to merge 1 commit into
mainfrom
docs/signal-inbox-expectations

Conversation

@MatthewSuttles

Copy link
Copy Markdown
Collaborator

Summary

  • Sets the right expectation when a user links a Signal channel: it's an inbox other people message to reach your agent, not a way to text your own agent from your personal number.
  • Kills the common "Note to Self / text it from my own phone" confusion at the source — Signal drops self-sent messages as loop protection, so it silently never works.

What changed

  • Connect page (connect.html.erb): amber callout for Signal channels explaining the number is reachable by others, that Note to Self won't reach the agent, and to test from a different phone.
  • Channel form (_form.html.erb): matching "What this is" note in the Signal setup block.

Both are Signal-only (gated on channel_type == "signal"); WhatsApp copy is untouched.

Why

Follow-up to #358 (Signal device-linking QR). The QR flow links the bot to the user's personal account, which lands users in the "Note to Self doesn't work" trap. This is the same architectural reality OpenClaw documents — easier to set expectations than to fight loop protection.

Test plan

  • Create a Signal channel → the form shows the amber "What this is" note
  • Click Connect → the connect page shows the inbox/Note-to-Self callout above the QR
  • Create a WhatsApp channel → no Signal copy appears
  • ERB renders cleanly (verified locally)

🤖 Generated with Claude Code

…text channel

Users linking a Signal channel expect to text their own agent from their
personal number (incl. "Note to Self"). Signal drops self-sent messages as
loop protection, so this never works and causes confusion.

Add expectation-setting callouts on the connect page and channel form
explaining that the linked number is an inbox others message to reach the
agent, that Note to Self won't reach it, and to test from a different phone.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant