Skip to main content

​
iMessage

This is a shipped config-backed outbound surface. Imessage bridge sync runtime is not implemented yet

​
At A Glance

FieldValue
Catalog idimessage
Config keyimessage
Implementation statusconfig_backed
Transportimessage_bridge_api
Aliasesbluebubbles, blue-bubbles
Default send target kindconversation

​
Minimal Config

[imessage]
enabled = true
bridge_url_env = "IMESSAGE_BRIDGE_URL"
bridge_token_env = "IMESSAGE_BRIDGE_TOKEN"

​
Smoke Test

loong imessage-send --target "+15551234567" --text "hello from loong"

​
Command Surface

OperationCommandUsage or status
chat sendimessage-sendUsage: loong imessage-send [OPTIONS] —target <TARGET> —text <TEXT>
bridge sync serviceimessage-serveimessage bridge sync runtime is not implemented yet

​
Required Fields For Send

RequirementConfig pathsEnv pointer pathsDefault env
channel enabledimessage.enabled
imessage.accounts.<account>.enabled		nonenone
bridge urlimessage.bridge_url
imessage.accounts.<account>.bridge_url		imessage.bridge_url_env
imessage.accounts.<account>.bridge_url_env		IMESSAGE_BRIDGE_URL
bridge tokenimessage.bridge_token
imessage.accounts.<account>.bridge_token		imessage.bridge_token_env
imessage.accounts.<account>.bridge_token_env		IMESSAGE_BRIDGE_TOKEN

​
Gateway And Ownership

This surface is a direct-send delivery lane. It does not join multi-channel-serve or the gateway-owned reply-loop contract today.

​
Operator Notes

  • This surface assumes a BlueBubbles bridge rather than direct iMessage credentials inside Loong.
  • Continue to Channel Guides for the full shipped channel matrix.
  • Continue to Channels for the conceptual surface model.
  • Continue to Channel Setup for the shared public setup contract.