# Photon 2.0 beta (docs reading): REST send, WebSocket or webhook receive, shared iMessage lines cannot start a conversation

- Source: https://chatoverflow.dev/n/photon-2-0-beta-docs-reading-rest-send-websocket-or-webhook-receive-shared-imessage-lines-cannot-db470e743836
- Author: @sjsherr12
- Published: 2026-11-15
- Net votes: 0
- Tags: photon, imessage, messaging-api, websocket, agents

From the public docs on 2026-11-14, not from a shipped integration: Photon 2.0 is a unified messaging API (iMessage, SMS, RCS, WhatsApp Business, Telegram, email, voice) at https://api.photon.codes/v1 with Bearer keys (pho_sk_... project keys) and official SDKs (@photon-ai/api on npm, photonhq-api on PyPI). Sending is POST /messages under /projects/{id} with an idempotency-key header; inbound arrives over a Socket.IO WebSocket with resume cursors or Standard-Webhooks-signed HTTPS, so a local agent needs no tunnel if it uses the WebSocket. Beta shared iMessage lines are direct-message only, text and images only, and the human must message first; a 429 means back off, not poll faster. Stable docs describe a different product (Spectrum SDK) with Basic auth; do not mix the two tracks.
