Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion calls/v4/react-native/overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -98,14 +98,14 @@
<Accordion title="Best Practices">
- Initialize `CometChatCalls` on app startup, right after `CometChat.init()`
- Use the Ringing flow for user-to-user calls where you need push notification support
- Use Call Session when building custom call UIs or conference-style experiences

Check warning on line 101 in calls/v4/react-native/overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

calls/v4/react-native/overview.mdx#L101

Did you really mean 'UIs'?
- Always request camera and microphone permissions before initiating a call
- Handle call errors gracefully and provide user-friendly feedback
</Accordion>
<Accordion title="Troubleshooting">
- **Calls not connecting:** Verify the Calls SDK is initialized after the Chat SDK and that both use the same App ID and Region
- **No audio/video:** Check that camera and microphone permissions are granted on both Android and iOS
- **Push notifications not arriving:** Ensure push notification setup is complete — see the [Push Notifications](/notifications/react-native-push-notifications-android) guide
- **Push notifications not arriving:** Ensure push notification setup is complete — see the [Push Notifications](/notifications/react-native-push-notifications) guide
- **iOS build fails:** Run `pod install` in the `ios` directory after adding the Calls SDK dependency
- **Android minSdkVersion error:** Set `minSdkVersion` to 24 or higher in your `build.gradle`
</Accordion>
Expand Down
13 changes: 8 additions & 5 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -6515,8 +6515,7 @@
"notifications/ios-fcm-push-notifications",
"notifications/flutter-push-notifications-android",
"notifications/flutter-push-notifications-ios",
"notifications/react-native-push-notifications-android",
"notifications/react-native-push-notifications-ios",
"notifications/react-native-push-notifications",
"notifications/web-push-notifications"
]
},
Expand Down Expand Up @@ -7135,7 +7134,7 @@
},
{
"source": "/extensions/react-native-push-notifications",
"destination": "/notifications/react-native-push-notifications-android"
"destination": "/notifications/react-native-push-notifications"
},
{
"source": "/extensions/capacitor-cordova-ionic-push-notifications",
Expand Down Expand Up @@ -7430,8 +7429,12 @@
"destination": "https://assets.cometchat.io/legacy-docs/notifications/push-notification-extension-legacy.html"
},
{
"source": "/notifications/react-native-push-notifications",
"destination": "/notifications/react-native-push-notifications-android"
"source": "/notifications/react-native-push-notifications-android",
"destination": "/notifications/react-native-push-notifications"
},
{
"source": "/notifications/react-native-push-notifications-ios",
"destination": "/notifications/react-native-push-notifications"
},
{
"source": "/rest-api/messages/list-reactions-with-a-specific-emojiunicodes",
Expand Down
3 changes: 1 addition & 2 deletions notifications.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -66,8 +66,7 @@ canonical: "https://cometchat.com/docs"

<Card title="Flutter (Android)" icon={<img src="/images/icons/flutter.svg" alt="Flutter (Android)" />} href="/notifications/flutter-push-notifications-android" horizontal />
<Card title="Flutter (iOS)" icon={<img src="/images/icons/flutter.svg" alt="Flutter (iOS)" />} href="/notifications/flutter-push-notifications-ios" horizontal />
<Card title="React Native (Android)" icon={<img src="/images/icons/react.svg" alt="React Native (Android)" />} href="/notifications/react-native-push-notifications-android" horizontal />
<Card title="React Native (iOS)" icon={<img src="/images/icons/react.svg" alt="React Native (iOS)" />} href="/notifications/react-native-push-notifications-ios" horizontal />
<Card title="React Native" icon={<img src="/images/icons/react.svg" alt="React Native" />} href="/notifications/react-native-push-notifications" horizontal />
<Card title="Web" icon={<img src="/images/icons/react.svg" alt="Web" />} href="/notifications/web-push-notifications" horizontal />
</CardGroup>
</div>
Expand Down
6 changes: 1 addition & 5 deletions notifications/push-overview.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -4,18 +4,18 @@
---

CometChat keeps users engaged when they are not in the app.
CometChat listens for chat and call events, assembles payloads from your templates, and delivers via FCM or APNs so taps land in the right conversation or call screen.

Check warning on line 7 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L7

Did you really mean 'APNs'?

## How it works at a glance

- **Providers + tokens**: Add FCM/APNs (and APNs VoIP) providers in the CometChat dashboard. Register device tokens in your app after login; unregister on logout.

Check warning on line 11 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L11

Did you really mean 'APNs'?

Check warning on line 11 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L11

Did you really mean 'unregister'?
- **Templates + payloads**: Customize notification text and sounds per message/call type (see Templates & Sounds). CometChat builds the payload and ships it to your provider.
- **Delivery guardrails**: Routing, retries, quiet hours, and DND/mutes are honored automatically; logs help you trace delivery.
- **Navigation**: Deep links open the right user/group/thread; call pushes can surface native call UI on supported platforms.

## Key capabilities

- Multi-platform coverage: Android, iOS (APNs or FCM), Flutter, React Native, and Web.

Check warning on line 18 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L18

Did you really mean 'APNs'?
- Message and call notifications with grouping, inline replies (where supported), and native call surfaces via CallKit/ConnectionService.
- Preferences: per-user/per-conversation mutes, quiet hours, and global DND.
- Timezone-aware scheduling for delayed/quiet-hour delivery.
Expand All @@ -29,15 +29,15 @@
- Call invites, missed calls, and ongoing call updates.

<Note>
**Call notifications and group calls:** Call-related push notifications (e.g., initiated calls, missed calls) are sent as **custom messages**, not as group action messages. The **production mode toggle** in the dashboard only affects APNs endpoint routing (sandbox vs production) — it does not change how CometChat constructs the push payload. If you experience APNs errors (e.g., 400 status) for call pushes, check your APNs provider credentials and certificate configuration rather than the production mode toggle.

Check warning on line 32 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L32

Did you really mean 'APNs'?

Check warning on line 32 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L32

Did you really mean 'APNs'?

Check warning on line 32 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L32

Did you really mean 'APNs'?
</Note>

## Before you integrate

1. **Dashboard setup**: In the CometChat dashboard, go to **Notifications → Settings**, enable **Push Notifications**, and click **Add Credentials** to add a provider (FCM for Android/iOS, APNs + optional APNs VoIP for iOS). In the credential dialog, **enter a Provider ID** — a unique identifier you choose — and upload the provider key (FCM service account JSON, or the APNs `.p8` with Team ID + Key ID).

Check warning on line 37 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L37

Did you really mean 'APNs'?

Check warning on line 37 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L37

Did you really mean 'APNs'?

Check warning on line 37 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L37

Did you really mean 'APNs'?
2. **Provider ID**: The **Provider ID** you set in step 1 is required at runtime — your app passes it to `registerPushToken(...)` so CometChat knows which credentials to use when sending a push. You can look it up any time under **Notifications → Settings**.
3. **Credentials**: Keep your App ID, Region, and Auth Key handy for initializing the SDK in your app.
4. **Client wiring**: Register tokens after login and unregister on logout. Follow the platform guide below for Gradle/Info.plist/CallKeep specifics.

Check warning on line 40 in notifications/push-overview.mdx

View check run for this annotation

Mintlify / Mintlify Validation (cometchat-22654f5b) - vale-spellcheck

notifications/push-overview.mdx#L40

Did you really mean 'unregister'?

## Choose your platform

Expand All @@ -63,11 +63,7 @@
UI Kit implementation
</Card>

<Card title="React Native (Android)" icon={<img src="/images/icons/react.svg" alt="React Native (Android)" />} href="/notifications/react-native-push-notifications-android">
UI Kit implementation
</Card>

<Card title="React Native (iOS)" icon={<img src="/images/icons/react.svg" alt="React Native (iOS)" />} href="/notifications/react-native-push-notifications-ios">
<Card title="React Native" icon={<img src="/images/icons/react.svg" alt="React Native" />} href="/notifications/react-native-push-notifications">
UI Kit implementation
</Card>

Expand Down
Loading
Loading