fix: update channel push CLI commands to use push publish --channel flag

[maratal]

Summary

• Replace legacy ably channels publish with inline JSON extras in APNs, FCM, and web push getting-started guides
• Use the new ably push publish --channel <name> flag with --title, --body, and --data options
• Update surrounding text to match the new command style

https://ably.atlassian.net/browse/DX-927

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 880ebe8a-b35d-4538-ac50-8bce0cbe4f3a

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch DX-927-new-CLI-push-commands-

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[sacOO7]

You might like to link push related commands to #3307

[maratal]

You might like to link push related commands to #3307

Added link to Next Steps fyi @sacOO7

[sacOO7]

We don't use --channel flag anymore, this was replaced by CHANNEL_NAME as per ably/ably-cli#361. You should check latest ably push docs at https://ably.com/docs/cli/push/publish

[Copilot]

Pull request overview

Updates the Push Notifications getting-started guides to use the newer Ably CLI push publish workflow for sending channel-based pushes, replacing the legacy channels publish example that embedded push extras JSON.

Changes:

• Replace the channel push example command with ably push publish --channel ... plus --title/--body and a JSON payload argument.
• Update surrounding instructional text to reflect the new CLI command style.
• Add a “next steps” link intended to point readers to push-related CLI options.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 6 comments.

File	Description
src/pages/docs/push/getting-started/web.mdx	Updates the channel push CLI example and adds a link to supposed push CLI command reference.
src/pages/docs/push/getting-started/fcm.mdx	Updates the channel push CLI example and adds a link to supposed push CLI command reference.
src/pages/docs/push/getting-started/apns.mdx	Updates the channel push CLI example and adds a link to supposed push CLI command reference.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[maratal]

We don't use --channel flag anymore, this was replaced by CHANNEL_NAME as per ably/ably-cli#361. You should check latest ably push docs at https://ably.com/docs/cli/push/publish

I think in the case of push publish this flag was introduced as a way to distinguish from --device-id and --client-id flags, since we decided to collapse a long channel publish command with extras.push field into this short version of push publish with --channel and --message flags.

[sacOO7]

We don't use --channel flag anymore, this was replaced by CHANNEL_NAME as per ably/ably-cli#361. You should check latest ably push docs at https://ably.com/docs/cli/push/publish

I think in the case of push publish this flag was introduced as a way to distinguish from --device-id and --client-id flags, since we decided to collapse a long channel publish command with extras.push field into this short version of push publish with --channel and --message flags.

You are right, seems it's the same way in doc as well as source code. The change was only made to ably push channels and not ably push publish so we are good.

[sacOO7]

It's better to give explicit link to ably cli page since new users will not be aware of it

[sacOO7]

LGTM
PS. Make sure we have consistent cross linking for Ably CLI across other pages.