FluffCams

Push Notifications Setup Guide  |  OneSignal Configuration for Site Owners

1
Create a OneSignal Account & App Free
dashboard.onesignal.com  ·  No credit card required for the free plan

OneSignal is the service that powers push notifications on your FluffCams site. You need to create a free OneSignal account and set up an "App" for your site. Each site gets its own App with its own credentials. The free plan supports unlimited web push subscribers and is more than sufficient for most sites.

Part A — Sign Up for OneSignal

1
Go to the OneSignal signup page

Navigate to https://app.onesignal.com/signup in your browser.

2
Enter your details and create an account

Fill in your email address, password, and company or website name. Agree to the terms and click Create Account.

3
Confirm your email address

OneSignal will send a confirmation email. Open it and click the Confirm Your Account button to activate your account.

4
Choose the Free plan

When prompted to select a plan, choose Free and click Get Started. You can always upgrade later if needed.

5
Fill in your role and company type (optional)

OneSignal may ask a few onboarding questions about your role and primary use. Fill these in and click Continue to proceed to the dashboard.


Part B — Create a New App for Your Site

1
Click "New App / Website" from the dashboard

Once inside the OneSignal dashboard, you will see a button to create a new app. Click it.

2
Name your app

Give the app a name that matches your site — for example: "My Cam Site". This name is only for your reference inside the OneSignal dashboard.

3
Select "Web" as the platform

When asked what platform you are setting up, choose Web. This covers browser-based push notifications for desktop and mobile browsers.

4
Choose "Custom Code" as the integration type

On the web configuration screen, you will be offered integration options such as WordPress, Shopify, and Custom Code. Select Custom Code — your FluffCams site handles the OneSignal integration in the background, so this is the correct choice.

5
Enter your site name and URL

Fill in your Site Name (what users will see in push notification prompts, e.g. "My Cam Site") and your full site URL (e.g. https://yoursite.com). Make sure you use https:// — push notifications require a secure connection.

6
Upload a notification icon (optional but recommended)

You can upload a square PNG icon (at least 256×256px) that will appear alongside push notifications sent from your site. Use your site logo. If you skip this, OneSignal will use a default icon.

7
Click Save and then Finish

Click Save to save your web push configuration, then click Finish on the next screen. Your OneSignal app is now created and active.

Skip the SDK installation steps. After finishing, OneSignal may show you code snippets and instructions for manually adding their SDK to your site. You can safely skip or dismiss these — your FluffCams script already includes the OneSignal integration. You do not need to add any code to your site manually.
2
Get Your App ID & REST API Key
OneSignal Dashboard → Settings → Keys & IDs

You need two pieces of information from OneSignal to connect it to your FluffCams admin panel: the App ID and the REST API Key. Both are found in the same place inside your OneSignal dashboard.

1
Open your OneSignal app

From the OneSignal dashboard at dashboard.onesignal.com, click on the app you just created.

2
Go to Settings → Keys & IDs

In the left sidebar of your app, click Settings, then click Keys & IDs.

3
Copy your OneSignal App ID

At the top of the page you will see your OneSignal App ID — a long string of letters and numbers. Click the copy icon next to it and paste it somewhere safe.

4
Generate a REST API Key

Scroll down to the API Keys section. Click the Add Key button. Give the key a name (e.g. "FluffCams") and click Create Key.

⚠ Important: The full REST API Key is displayed only once in a pop-up when it is first created. Copy it immediately and store it somewhere safe — such as a text file or password manager. If you close the pop-up without copying it, you will need to delete the key and generate a new one.
5
You now have both credentials

You should have your App ID and your REST API Key ready to paste into the FluffCams admin panel. Continue to Section 3.

Your OneSignal Credentials Summary

Where to find them Dashboard → Your App → Settings → Keys & IDs
OneSignal App ID Listed at the top of the Keys & IDs page
REST API Key Generated under API Keys → Add Key (shown once only)
3
Configure Push Notifications in Your Admin Panel
Your Site Admin → Push Notifications Settings

With your OneSignal credentials ready, you can now connect your site to OneSignal through the FluffCams admin panel. This takes just a few fields to fill in.

1
Log in to your FluffCams Admin Panel

Go to https://yoursite.com/admin and log in with your admin credentials.

2
Navigate to the Push Notifications settings page

Find the Push Notifications section in your admin panel menu.

3
Enable Push Notifications

Toggle the Enable Push Notifications (OneSignal) switch to On. This activates the push system across your site. When enabled, users will be prompted by their browser to allow notifications when they visit.

4
Fill in your OneSignal credentials

Enter the two values you copied from OneSignal in the fields below:

FluffCams Admin Panel — Push Notification Settings
OneSignal App ID Paste your App ID from OneSignal → Settings → Keys & IDs
REST API Key Paste your REST API Key (stored encrypted in the database)
Security note: Your REST API Key is encrypted before being stored in the database. It is never stored or displayed in plain text after you save. If you ever need to update it, simply paste the new key into the field and save again.
5
Save your settings

Click Save Settings. Your site is now connected to OneSignal and push notifications are live.

6
Test it by visiting your site

Open your site in a browser (Chrome or Firefox recommended for testing). Within a few seconds you should see a browser permission prompt asking if you want to allow notifications from your site. If you see this prompt, your setup is working correctly.

⚠ Not seeing the permission prompt? If no prompt appears, your browser may have previously blocked notifications for this site. In Chrome, click the lock icon in the address bar → Site Settings → Notifications → Reset to default. Then reload the page.
4
How Push Notifications Work on Your Site
What your users experience and what gets sent

Once configured, the push notification system runs automatically in the background. Here is what your users will experience and what types of notifications are sent.

User Experience

1
Permission prompt on first visit

When a user visits your site for the first time after push is enabled, their browser will display a prompt asking permission to send notifications. The user can click Allow or Block.

2
Notifications delivered even when the browser is closed

Once a user allows notifications, they will receive push alerts even if they are not actively on your site — as long as their browser is running in the background.

3
Users control their own preferences

Users can toggle push notifications on or off at any time from their account settings on your site. They can also disable push and email notifications independently of each other.

4
No notifications sent during active chat

If a user is actively viewing a chat session, push notifications are suppressed for that session so they are not interrupted. Notifications resume when they leave the page.


What Triggers a Push Notification

For Fans / Users
  • New message received from a model
  • A followed model goes live
  • Fan club subscription confirmation
  • Any event that also sends an email
For Models
  • New tip received
  • New message from a fan
  • New fan club subscriber
  • Any event that also sends an email
How it works behind the scenes: Any event on your site that triggers an email notification will also trigger a push notification through OneSignal — automatically, with no extra configuration required. The two systems run in parallel. If push is disabled by the site owner or by an individual user, only the email is sent.
FluffCams Customer Documentation  |  For support, open a ticket from your FluffCams customer portal
Scroll to Top