Skip to content

Frequently Asked Questions

Welcome to the AlertWise FAQ page! Here, you’ll find answers to the most commonly asked questions about AlertWise Web Push Notifications—how they work, why they’re beneficial, and how to integrate them into your website. Whether you’re a developer looking for API details or a marketer wanting to optimize engagement, this page covers everything you need to know. 🚀

1. Getting Started

Learn how to set up and configure the Web Push SDK, including installation, permissions, and basic functionality to start sending notifications.

Check Details

What is AlertWise?

AlertWise is a Web Push Notification service for HTTPS websites, supporting all major platforms. It allows developers to customize notifications via REST and JavaScript APIs while offering real-time analytics and key insights through an online Dashboard.

How do Web Push Notifications work?

Push notifications are clickable messages sent to users’ desktops or mobile devices even when they are not actively on your website. They have 10X higher conversions compared to email and better opt-in rates. Notifications can include text, images, and sounds.

How does AlertWise handle push notifications?

  • Subscription – Users opt-in via their browser (no email or personal data required).
  • Sending Notifications – Businesses can send custom messages with a title, text, and image.
  • Re-engagement – Notifications bring users back to the site even when they are not actively browsing.

Why should I use AlertWise for push notifications?

Key Benefits of AlertWise:

  • Easy Setup – Integrate with just a single step. Plugins for WordPress and more are in development.
  • Advanced Marketing Tools – Features like Audience Creator, A/B Testing, segmented targeting, localization, and conversion tracking help optimize campaigns.
  • Real-Time Analytics – Provides insights on click timing, geo-location, and more.
  • Developer-Friendly – REST & JavaScript APIs allow full customization.
  • Multi-Platform & Browser Compatibility – Works across all major platforms & browsers.
  • Multilingual Support – Personalize notifications in different languages.

How do I get started with AlertWise?

To start using AlertWise:

  1. Create a free account on AlertWise.
  2. Integrate the provided code into your website.
  3. Gain subscribers and start sending notifications directly from the Dashboard.

What is a web push subscriber in AlertWise?

A web push subscriber is anyone who clicks “Allow” on the subscription popup on your site. Unlike email or SMS campaigns, web push notifications do not collect personal information like emails or phone numbers but allow you to engage with users even when they are not on your website.

How do I install AlertWise on my website?

To install AlertWise:

  • Log in to the AlertWise platform.
  • Add an app by providing:
    • Site/App Name
    • Site URL (must follow the same-origin policy)
    • Badge Icon URL (for branding)
    • Notification Icon URL
  • Copy the installation code and add it to your website’s HTML.
  • Download and place the service-worker.js file in your root directory for proper functioning.

What are the requirements for adding a new website?

  • Site Name and Site URL are mandatory for registering an app.
  • Default Icon URL should be a 256x256 px PNG or JPG file.
  • Subscribers are automatically resubscribed when they revisit your site unless they disable push notifications.

How do I set up the subscription opt-in prompt?

You can configure the subscription opt-in by navigating to Settings > Subscription Prompt in the AlertWise Dashboard.

  • Single Step Opt-in: Enables one-click subscriptions.
  • Double Step Opt-in: Allows customization but requires users to confirm in two steps.
  • After customization, Save and Enable the Prompt.

How do I create my first push notification?

  1. Go to Dashboard > Notifications > Send.
  2. Enter the Notification Title, Message, URL, and Image (ensure they meet character and size requirements).
  3. Click Save and Select Audience, then choose Send to All Subscribers/Group.

What happens if a user revisits my site after subscribing?

Subscribers are automatically resubscribed when they return to your site. They won’t see the opt-in prompt again unless they manually disable push notifications in their browser settings.

2. Notification

Understand how push notifications work, customize their appearance, schedule messages, and handle user interactions for an engaging experience.

Check Details

What do I need to do before creating a push notification campaign?

Before launching a campaign, ensure that:

  • AlertWise is properly installed on your website.
  • You have collected subscribers (without subscribers, notifications won’t reach anyone).
  • You’ve decided whether to send notifications to all subscribers or targeted segments (available in the Subscription plan and above).

What are the character limits for push notifications?

  • Message Length: Up to 192 characters (supports emojis 😊).
  • Title Length: Up to 64 characters.
  • Large Image: Maximum 5MB
    • Desktop: 360×180 px
    • Mobile: 360×80 px
  • Notification Icon: 192×192 px

How can I make my push notifications more engaging?

  • Multi-Action Notifications: Add buttons to encourage user interaction.
  • Large Images: Improve visibility and increase click rates.

How long do notifications last before expiring?

Notifications can last up to 28 days before they expire. You can set a custom expiry time to prevent overwhelming subscribers.

Can I send push notifications to a targeted audience?

Yes! You can include or exclude specific user segments to increase engagement by sending targeted notifications.

Can I schedule push notifications for a later time?

Yes! AlertWise allows you to:

  • Schedule notifications for a specific date and time.
  • Set up recurring notifications outside working hours.

How do I launch my first push notification campaign?

  1. Go to Dashboard > Notifications > Send.
  2. Enter Notification Title, Message, URL, and Image.
  3. Choose an audience segment (if applicable).
  4. Click Send to launch your campaign! 🚀

What if I need help setting up my first push campaign?

If you need assistance, you can contact AlertWise support for help.

Why should I include a large image in my push notification?

Adding a large image enhances visibility and engagement, making notifications more appealing. This helps increase click-through rates (CTR) and ROI.

How do I create a push notification with a large image?

  1. Log in to your AlertWise dashboard.
  2. Go to Notification > Send and click Create Your First Notification.
  3. Click New Push Broadcast and enter the title, message, and URL.
  4. Enable Large Image Notifications by toggling the Choose Image button.
  5. Upload an image from:
    • Your Local Disk
    • A Web Address (URL)
    • The Gallery (previously uploaded images)
  6. Click Use to add the image.
  7. Click Save and Send/Schedule to finalize.

What are the image size guidelines for push notifications?

Image TypeSize (px)Supported Devices
Notification Icon192 × 192Mobile & Desktop
Large Image (Desktop)360 × 180Chrome 52+ (Desktop)
Large Image (Mobile)360 × 80Mobile Devices

💡 The Notification Icon should be a solid square for best visibility.

Is there a file size limit for images?

Yes, AlertWise allows images up to 5MB. Video and audio uploads are not supported.

How long does AlertWise store uploaded images?

AlertWise stores images for 30 days. After that, you must re-upload the image if reusing a draft notification.

Can I send different images for mobile and desktop?

Yes, you can choose separate images based on device type (Desktop/Mobile) to optimize the display.

How do I send or schedule the notification?

After setting up your notification:

  • To send immediately, select Begin Sending Immediately and click Send Notification Now.
  • To schedule for later, choose the date and time under the Send/Schedule tab.

What should I do if I face issues while sending a notification?

If you need help, contact AlertWise Support for assistance.

Does AlertWise support all character encodings?

Yes! AlertWise fully supports UTF-8, allowing notifications to include:

  • Special characters & symbols
  • Non-Latin scripts (e.g., Chinese, Japanese, Arabic, Hindi)
  • Mathematical & scientific symbols
  • Any other Unicode-supported characters

This ensures notifications display correctly across all devices and platforms without encoding issues.

Can I use emojis in my notifications?

Absolutely! 😊 Emojis enhance engagement and make notifications more expressive. AlertWise supports all Unicode emojis, including:

  • 🔥 🚀 🎉 ❤️ 😊 😀
  • 👉 Skin tone variations (👍🏽, ✋🏾, etc.)
  • 🏳️‍🌈 Country flags (🇺🇸, 🇮🇳, 🇩🇪, etc.)
  • 🆕 Newly released emojis (based on Unicode updates)

How do I add emojis to my notification?

When creating a notification in the AlertWise dashboard:

  1. Click on the Emoji Icon (😊) to open the emoji list.
  2. Search emojis by name (e.g., “heart” for ❤️).
  3. Directly type or paste emojis into the title/message field.
  4. Mix text & emojis freely without affecting delivery.

Example of a notification with emojis

💬 Title: 🔥 Limited Offer! 📢 Message: Get 50% OFF today only! 🚀 Click now!

This ensures a visually engaging notification that boosts clicks.

Will emojis display correctly on all devices?

Most modern devices and browsers fully support Unicode emojis. However:

  • ⚠️ Older devices or OS versions may not support newer emojis.
  • ⚠️ Unsupported emojis might appear blank or as boxes (□).

What Are Action Buttons?

Action buttons let users interact directly with your push notifications by adding clickable Call-to-Action (CTA) buttons.

These buttons can:

  • Drive traffic to your website
  • Open an app
  • Perform specific user actions
  • Increase engagement & conversions

How to Add Action Buttons

  • Enable Action Buttons
    • In the AlertWise dashboard, toggle “Add Action Buttons” ON
    • You can configure up to two action buttons

First Action Button Setup

  • First Button Title: Text displayed on the button (e.g., Buy Now)
  • First Button URL: The link where users are directed when they click the button
  • First Button Image URL (Optional): A small image/icon to appear alongside the button

Second Action Button (Optional)

Want to add a second button? Simply toggle “Show Second Button” ON and configure:

  • Second Button Title: Text displayed (e.g., Learn More)
  • Second Button URL: The destination URL
  • Second Button Image URL (Optional): Small image/icon for the second button

Example Notification with Action Buttons

  • Title: Exclusive Offer!
  • Message: Get 50% OFF today only!
  • Action Button 1: Buy Now → [URL]
  • Action Button 2: Learn More → [URL]

Best Practices for Action Buttons

  • Keep text concise: Short, action-driven phrases like Buy Now or Learn More
  • Ensure valid URLs: Make sure links work and lead to relevant content
  • Use high-quality images: Icons should be clear, optimized, and visually appealing
  • Limit the number of buttons: Too many options overwhelm users—stick to only relevant actions

What happens if a device is offline when a notification is sent?

If a device is offline, the notification will be stored until the TTL expires (up to 28 days). Once the device is back online, it will receive the notification only if TTL has not expired.

What is the default TTL for push notifications?

The default Time-To-Live (TTL) varies by browser but can be customized in AlertWise. By default, many browsers store notifications for a few days unless specified.

Can I set a notification to expire immediately if undelivered?

Yes! Setting TTL = 0 ensures the notification expires instantly if it cannot be delivered.

How does notification replacement work?

On supported browsers (Chrome, Edge, Firefox):

  • If a new notification arrives while an older one is still unread, the new notification replaces the old one.
  • This prevents users from getting multiple redundant notifications.

What is the benefit of using Web Push Topics?

  • Web Push Topics allow grouping related notifications together instead of replacing them.
  • Example: If you send breaking news updates, users will see one expandable notification instead of multiple messages.

Does every browser support Notification Duration & TTL?

  • No, support depends on the browser:
  • Chrome 47+, Edge, and Firefox support it.
  • Safari has limited support for TTL-based notifications.

Can I manually remove notifications before TTL expires?

Yes, AlertWise allows manual removal via API calls if needed.

What happens if I set a long TTL but the user never opens the notification?

The notification will stay active until:

  • The user interacts with it.
  • The TTL expires.
  • A new notification replaces the old one (if enabled).

Does enabling Notification Priority affect delivery speed?

No, it only affects how the notification is displayed to the user:

  • Low: Less intrusive, may be grouped.
  • Normal: Standard notification.
  • High: Immediate & more prominent.

Can I use TTL and Notification Duration together?

Yes! You can set TTL to manage how long notifications stay in the system and use Notification Duration to control how long they remain visible on-screen.

3. Audience

Manage your subscribers effectively by segmenting users, targeting specific groups, and optimizing notification delivery for better engagement.

Check Details

What is an audience in push notifications?

An audience consists of users who will receive your push notifications. You can define an audience using subscribers, segments, or audience groups.

How can I create an audience for push notifications?

You can create an audience using two methods:

  • Dashboard: Manually define an audience using segments and audience groups.
  • API: Dynamically build an audience using filters, segments, or user aliases.

What is the difference between Subscribers, Segments, and Audience Groups?

  • Subscribers – Individual users who have opted in for notifications.
  • Segments – Groups of users categorized by behavior, location, or device type.
  • Audience Groups – Predefined user sets for quick targeting.

Can I target specific users based on their behavior?

Yes! You can create behavior-based segments to target users based on their actions, such as:

  • Users who haven’t opened the app in 7 days.
  • Users who added items to their cart but didn’t check out.

What are the benefits of audience segmentation?

Audience segmentation helps with:

  • Personalized Messaging – Deliver content that matters to users.
  • Better Targeting – Reach the right users at the right time.
  • Higher Engagement & Conversions – Improve click-through rates.

How often are audience segments updated?

Segments update automatically based on real-time user actions and preferences.

Can I send notifications to multiple audience groups at once?

Yes! You can select multiple audience groups when sending a notification.

What happens if a user belongs to multiple segments?

The user will receive only one notification, even if they belong to multiple segments in the same campaign.

Can I exclude certain users from an audience?

Yes! You can use exclusion filters to prevent notifications from reaching specific users.

How do I know which audience segment performs best?

Use analytics to track engagement, click-through rates, and conversions for each segment.

What is an Audience Group?

An Audience Group is a collection of subscribers grouped based on specific criteria such as location, device, browser, or engagement history. This helps in sending targeted push notifications for better engagement.

How do I create an Audience Group?

To create an Audience Group:

  • Go to the Audience Groups page.
  • Click on Create Audience Group.
  • Enter a name and description.
  • Define selection criteria such as device, location, browser, or user activity.
  • Add multiple filter conditions or conditions if needed.
  • Click Save Audience Group to finalize it.

Can I edit an existing Audience Group?

Yes, you can edit an Audience Group by clicking the edit (pencil) icon next to it. You can modify the name, description, and selection criteria as needed.

What happens if a user no longer matches the criteria of an Audience Group?

If a subscriber’s details (such as location, browser, or segment) change, they may be automatically removed from an Audience Group if they no longer match the selection criteria.

How do I delete an Audience Group?

To delete an Audience Group:

  1. Visit the Audience Groups page.
  2. Click the delete (trash) icon next to the group you want to remove.
  3. Confirm the deletion.

Can I use multiple filters to define an Audience Group?

Yes, you can apply multiple filter conditions (AND conditions) and OR conditions to refine your audience group selection further.

How do I check how many subscribers are in an Audience Group?

When creating or editing an Audience Group, the system dynamically calculates the number of subscribers that match your criteria. A Pie Chart and Refresh Count Button are available for real-time insights.

Can I create an Audience Group based on user activity?

Yes, you can define an Audience Group based on engagement metrics like:

  • Last Sent Date (when the user last received a notification)
  • Last Click Date (when the user last clicked on a notification)
  • Total Click Count (total number of times the user clicked notifications)

Will deleting an Audience Group affect my existing campaigns?

No, deleting an Audience Group only removes it from future targeting options. Any campaigns that already used the group will remain unaffected.

Why should I use Audience Groups?

Using Audience Groups helps in:

  • Better Targeting – Reaching the most relevant users.
  • Higher Engagement – Improving click-through and view rates.
  • Personalized Messaging – Sending messages based on user behavior.
  • Efficient Campaigns – Saving time by using predefined audience segments.

What is the Subscribers Page?

The Subscribers page provides an overview of all users who have subscribed to your push notifications. It includes detailed information such as device type, browser, operating system, country, and last session date.

What data is displayed in the Subscribers Table by default?

The default columns in the Subscribers Table include:

  • Subscriber ID (🔒 Cannot be removed)
  • Device (Desktop, Mobile, Tablet)
  • Browser (Chrome, Firefox, Edge, etc.)
  • Operating System (Windows, macOS, Linux, Android, iOS)
  • Country (Subscriber’s registered location)
  • Last Session (🔒 Cannot be removed) – Shows the last recorded activity of the subscriber

Can I customize the columns in the Subscribers Table?

Yes, you can customize the table by adding, removing, or reordering columns.

How do I customize the Subscribers Table?

To customize the table:

  • Click the Settings (⚙️) button.
  • Modify the columns in the customization modal:
    • Displayed Columns (Left Side) – Drag & drop to sort.
    • Hidden Columns (Right Side) – Click (+) to add fields.
  • Click OK to save your changes.

What additional columns can I add to the table?

You can enable extra fields like:

  • City (Subscriber’s current city)
  • Region (State or province)
  • Currency (Based on subscriber’s country)
  • Time Zone (Subscriber’s time zone)

Can I reorder the columns in the table?

Yes, you can reorder columns by dragging and dropping them within the displayed columns section.

Can I remove any column from the table?

You can remove most columns except Subscriber ID and Last Session, as they are mandatory.

What does ‘Last Session’ mean?

‘Last Session’ shows the last recorded time the subscriber was active on your website or app.

Why should I customize the Subscribers Table?

Customizing the table helps you:

  • Gain Better Insights – Track subscriber behavior efficiently.
  • Enhance Flexibility – Display only the data that matters to your business.
  • Improve Targeting – Use detailed subscriber data for refined audience segmentation.

Will my column preferences be saved permanently?

No, the selected columns will reset when you leave the page. You need to customize them again when revisiting.

4. Analytics

Track and analyze notification performance using real-time metrics, delivery reports, and engagement insights to improve communication strategies.

Check Details

What is the Analytics Overview?

The Analytics Overview provides a performance summary of your push notification campaigns. It includes key metrics like total subscribers, notifications sent, delivery rates, and user engagement trends.

What data is shown in the Overview section?

The Overview section displays key performance metrics, comparing current data with the previous 30 days to show trends in subscriber activity and notification engagement.

What is the purpose of the Interactive Graph Section?

The Interactive Graph visually represents push notification performance over time, allowing you to track trends and engagement.

Can I filter the data for a specific time period?

Yes, you can filter data by selecting a time range:

  • Last 7 Days
  • Last 30 Days
  • This Month
  • Last Month
  • Last 3 Months
  • Last 6 Months
  • This Year
  • Last Year
  • Custom Range (Manually select dates)

What metrics can I view on the graph?

The graph can display:

  • New Subscribers – Users who subscribed in the selected period.
  • Unsubscribes – Users who unsubscribed.
  • Notifications Sent – Total push notifications sent.
  • Sent (Subscribers) – Notifications sent to active subscribers.
  • Sent (Unsubscribes) – Notifications sent to users who later unsubscribed. Delivered (Subscribers) – Successfully delivered notifications.
  • Clicked – Notifications that users clicked.

What is the Daily Performance Table?

The Daily Performance Table provides a day-by-day breakdown of key analytics metrics.

What do the columns in the Daily Performance Table mean?

  • Date – The recorded date of the data.
  • Sent – Total notifications sent.
  • Viewed – Number of notifications seen by users.
  • Clicked – Number of notifications clicked.
  • CTR (%) – Click-Through Rate, calculated as (Clicked ÷ Sent) × 100.
  • New Subscribers – Users who subscribed on that date.
  • Unsubscribed – Users who unsubscribed.

Why is the Click-Through Rate (CTR) important?

CTR helps measure user engagement by showing the percentage of users who clicked on notifications after receiving them. A higher CTR indicates effective messaging.

How can I use this data to improve my campaigns?

  • Track Performance in Real-Time – Identify what’s working and optimize accordingly.
  • Customize Reports – Focus on specific timeframes and metrics for better analysis.
  • Optimize Engagement Strategies – Adjust targeting, timing, and messaging to improve subscriber interaction.

Can I download or export these analytics reports?

Currently, there is no mention of an export feature. However, you can take screenshots or manually record insights to track trends over time.

What is Subscription Analytics?

Subscription Analytics provides insights into subscriber growth and retention trends. It helps track new subscriptions, unsubscribes, and audience demographics to refine push notification strategies for better engagement.

What does the Subscription Overview show?

The Subscription Overview provides a high-level summary of subscriber activity, helping you track new subscribers, unsubscribes, and overall audience growth over time.

The Subscription Trends Graph visually represents the number of new subscribers and unsubscribers over a selected time period, allowing you to track audience retention and churn trends.

Yes, you can filter data by selecting a time period:

  • Last 7 Days
  • Last 30 Days
  • This Month
  • Last Month
  • Last 3 Months
  • Last 6 Months
  • This Year
  • Last Year
  • Custom Range (Manually select dates)

The graph displays:

  • New Subscribers – Users who opted in to receive push notifications.
  • Unsubscribers – Users who opted out of receiving notifications.

What insights does the Demographic Overview provide?

The Demographic Overview includes four pie charts to help understand audience distribution:

  • Country Breakdown – Percentage of subscribers from different countries.
  • Browser Breakdown – Percentage of subscribers using various browsers.
  • Device Breakdown – Distribution of subscribers by device type (mobile, desktop, tablet).
  • Operating System Breakdown – Percentage of subscribers using different operating systems (Windows, macOS, Android, iOS, etc.).

Why is the Demographic Overview useful?

It helps tailor push notification campaigns based on audience location, browser preferences, device types, and operating systems for better engagement.

How can I use Subscription Analytics to improve my campaigns?

  • Track Subscriber Growth – Identify audience trends over time.
  • Monitor Unsubscribes – Detect patterns in user drop-offs.
  • Improve Targeting – Use demographic data to send more relevant notifications.
  • Optimize Engagement – Adjust message content, timing, and format based on device and OS preferences.

Yes, you can toggle the visibility of New Subscribers and Unsubscribers to focus on specific data points.

Does Subscription Analytics show real-time data?

Subscription Analytics reflects data updates at regular intervals, but it may not always be in real-time. However, it provides a clear snapshot of recent trends and user behavior.

5. Settings

Customize SDK behavior, manage preferences, update configurations, and adjust notification permissions to align with your requirements.

Check Details

What is the Web Configuration setting?

The Web Configuration setting allows you to set up essential details for your website’s push notifications, including:

  • Site Name – Displayed in notification prompts and branding.
  • Site URL – The full website URL where push notifications will be integrated.
  • Site Icon – The image shown in notifications for brand recognition.

How do I configure my website for push notifications?

To configure your website, fill in the Site Name and Site URL fields, then upload a site icon for branding.

How do I upload my site icon?

  1. Click the “Upload Image” button.
  2. A popup will appear with the following options:
    • Upload: Manually select an image from your device.
    • Recent Files: Choose from previously uploaded images.
    • External Image URL: Paste a URL for an externally hosted icon.

What are the requirements for the site icon?

  • Dimensions: Square image (e.g., 192x192 pixels).
  • Formats: JPG, JPEG, PNG, GIF, WEBP, AVIF, SVG.
  • File Size: Up to 2MB.
  • Animated images are NOT supported.

Can I use an externally hosted image for my site icon?

Yes! Using an External Image URL is recommended if you prefer hosting your icon on a CDN or your own server, allowing for easy updates without re-uploading.

How can I remove the “Powered by AlertWise” branding?

  • Free plan users cannot remove the “Powered by AlertWise” label.
  • To enable white-label notifications, upgrade to AlertWise Pro.

Why should I remove branding?

Creates a more professional experience. Strengthens brand trust and recognition.

How do I save my site configuration settings?

After filling out the form, click “Save Changes” to apply your updates.

6. Integration

Seamlessly integrate the Web Push SDK with your website, CMS, or third-party tools to enhance functionality and streamline workflows.

Check Details

How do I integrate AlertWise into my website?

To integrate AlertWise push notifications, include the provided JavaScript code inside the <head> tag of your website.

What is the required script for integration?

Copy and paste the following code into the <head> section of your HTML:

<script src="https://cdn.alertwise.net/alertwise/integrate/alert-wise.js"></script>
<script type="text/javascript">
alertwise = window.alertwise || [];
alertwise.push(["init", {
appId: "67a60e5304bd5***********",
applicationServerPublicKey: "BHzAcTE79fOXRfhHzEn6A0thxyjSw7Np99BF7**************************************************"
}]);
</script>

Where should I place this script on my website?

Place the script inside the <head> tag of your website’s HTML file. This ensures proper initialization when users visit your site.

What does the appId do?

The appId uniquely identifies your AlertWise application and connects your website to the push notification service.

What is the applicationServerPublicKey?

This key is required for Web Push Protocol, allowing browsers to verify the push notifications’ authenticity.

Do I need to modify the script?

No modifications are needed unless:

  • You are provided with a different appId or public key.
  • You have multiple instances and need to configure separate environments.

What happens after adding the script?

Once added, AlertWise will automatically:

  • Detect visitor subscriptions.
  • Enable push notifications for your site.
  • Provide real-time notification delivery.

Is this integration required for all websites?

Yes, if you want to enable push notifications via AlertWise, this script must be included on every page where notifications should work.

What is the AlertWise WordPress Plugin?

The AlertWise WordPress Plugin enables automatic push notifications when a post or page is published or updated. It helps keep your audience engaged with real-time updates.

How do I install the AlertWise WordPress Plugin?

Follow these steps:

  1. Log in to your WordPress Admin Dashboard.
  2. Go to Plugins > Add New.
  3. Search for “AlertWise” in the search bar.
  4. Click “Install Now” on the AlertWise plugin.
  5. After installation, click “Activate”.

Where can I access the AlertWise Plugin after installation?

After activation, navigate to the AlertWise Plugin Home Page from the WordPress dashboard. On this page, you’ll find:

  • Installation Video – Step-by-step video guide.
  • Installation Guide – Written instructions.
  • Useful Blog Articles – Best practices for push notifications.

How do I configure API settings?

  1. Click “Get Started” to open the AlertWise Plugin Settings.
  2. Go to the API Configuration Tab.
  3. Enter your App ID (Required).
  4. The Application Server Public Key will auto-populate.
  5. Click “Verify & Save” to confirm credentials.

How can I enable automatic push notifications?

Under the Notification Settings Tab, you can:

  • Enable Auto-Notifications when a POST is published/updated.
  • Enable Auto-Notifications when a PAGE is published/updated.
  • Click “Save Changes” to apply.

How do I send notifications when publishing a post or page?

When enabled, the AlertWise Panel appears in the WordPress Editor (Right Sidebar Panel) with options:

  • Automatically send notifications when a post/page is published or updated.
  • Select Audience Group – Choose from a dropdown or create a new group.
  • Send to All Users – Notify all subscribers.

7. Developer

Access technical documentation, API references, and advanced troubleshooting guides to help developers optimize and debug SDK implementations.

Check Details

What is the Web Push SDK?

The Web Push SDK is a client-side JavaScript library designed for browser environments. It enables websites to send push notifications to users, ensuring real-time updates and alerts. It is compatible with all major web browsers and works on both HTTP and HTTPS websites.

What are the key features of the Web Push SDK?

  • Push Notifications: Enables real-time notifications for users.
  • Broad Browser Compatibility: Supports all major web browsers.
  • Easy Integration: Simple to integrate into any website.
  • Subscription Management: Tools for managing subscriptions, unsubscriptions, and audience segments.
  • Event Tracking: Tracks user interactions like permission prompts, notification clicks, and dismissals.
  • Customization: Allows customization of notification behavior and appearance.

What are the system requirements for using the Web Push SDK?

  • Browser Support: Works on all major browsers (Chrome, Firefox, Safari, Edge, etc.).
  • SSL Certificate: Requires an SSL certificate signed by a trusted authority for Chrome push notifications.
  • No Incognito/Guest Mode: Push notifications do not work in Incognito or Guest modes.
  • Safari Limitation: Auto-subscription is not available for Safari.

How do I initialize the Web Push SDK?

To initialize the SDK, include the following code in your HTML file <head>:

example.html
<script src="https://cdn.alertwise.net/alertwise/integrate/alert-wise.js"></script>
<script type="text/javascript">
alertwise = window.alertwise || [];
alertwise.push(["init", {
appId: "6749d6ee72da9a4b348xxxxx"
}]);
</script>

appId: A unique ID for your website (required).

applicationServerPublicKey: Optional. If not provided, it will be fetched from the system table.

segment: Optional. Assigns segments to subscribers during the subscription process.

How do I update the AppConfig?

The updateAppConfig method allows you to customize the SDK’s behavior. Here’s an example:

alertwise.push(function () {
alertwise.updateAppConfig({
appId: "6749d6ee72da9a4b3-XXXXX",
scope: "/root/page"
});
});

Schema:

interface AppConfig {
appId: string;
alertwiseApiUrl?: string;
scope?: string;
language?: string;
serviceWorkerUrl?: string | null;
applicationServerPublicKey?: string;
defaultNotificationImage?: string;
defaultNotificationTitle?: string;
segments?: string | string[];
}

How do I retrieve a subscriber’s ID?

Use the getSubscriberId method to retrieve a user’s unique subscriber ID:

alertwise.push(function () {
alertwise.getSubscriberId()
.then(x => console.log(`Subscription Id received: ${x}`))
.catch(error => console.log(error.message, error.details));
});

Returns: A unique subscriber ID or null if the user is not subscribed.

How do I get subscriber details?

Use the getSubscriber method to fetch subscriber details:

alertwise.push(function () {
alertwise.getSubscriber()
.then(x => console.log(`Subscriber Details: ${JSON.stringify(x)}`))
.catch(error => console.log(error.message, error.details));
});

Response Object:

interface ISubscription {
id: string;
appId: string;
endpoint: string;
p256dh: string;
auth: string;
browser: string;
device: string;
os: string;
city: string;
region: string;
country: string;
currency: string;
language: string;
timeZone: string;
timeZoneOffset: number;
subscriptionAt: string;
}

How do I check if push notifications are supported?

Use the isPushNotificationSupported method:

alertwise.push(function () {
alertwise.isPushNotificationSupported()
.then(x => console.log(`isPushNotificationSupported: ${x}`))
.catch(error => console.log(error.message, error.details));
});

Returns: true if supported, false otherwise.

How do I unsubscribe a user?

Use the unsubscribe method to stop sending push notifications to a user:

alertwise.push(function () {
alertwise.unsubscribe()
.then(x => console.log(`unsubscribe response: ${JSON.stringify(x)}`))
.catch(error => console.log(error.message, error.details));
});

Response Sample:

{
"message": "<response Message>"
}

How do I check a user’s notification permission status?

Use the getPermission method:

alertwise.push(function () {
alertwise.getPermission()
.then(x => console.log(`getPermission response: ${JSON.stringify(x)}`))
.catch(error => console.log(error.message, error.details));
});

Returns: default, granted, or denied.

What events are available in the Web Push SDK?

The SDK provides several events to track user interactions:

  • AlertWise.onReady: SDK is ready.
  • AlertWise.onSDKError: Unhandled SDK exception.
  • AlertWise.onSWError: Unhandled Service Worker exception.
  • AlertWise.onSubscriptionChange: Subscription or re-subscription.
  • AlertWise.onUnsubscribe: Unsubscription.
  • AlertWise.onPermissionPromptDisplayed: Permission prompt displayed.
  • AlertWise.onPermissionPromptGranted: Permission granted.
  • AlertWise.onPermissionPromptDenied: Permission denied.
  • AlertWise.onNotificationDisplayed: Notification displayed.
  • AlertWise.onNotificationClick: Notification clicked.
  • AlertWise.onNotificationClose: Notification closed.

How do I listen to SDK events?

Use window.addEventListener to listen to events. For example:

window.addEventListener('AlertWise.onReady', function (event) {
console.log(event.detail);
});

What are the limitations of the Web Push SDK?

  • Self-Signed Certificates: Chrome push notifications require an SSL certificate signed by a trusted authority.
  • Incognito/Guest Mode: Push notifications do not work in these modes.
  • Safari: Auto-subscription is not supported.

How do I handle errors in the SDK?

Use the `onSDKError and onSWError events to handle errors:

window.addEventListener('AlertWise.onSDKError', function (event) {
console.log(event.detail);
});
window.addEventListener('AlertWise.onSWError', function (event) {
console.log(event.detail);
});

How do I track notification interactions?

Use the following events:

  • onNotificationDisplayed: Notification displayed.
  • onNotificationClick: Notification clicked.
  • onNotificationClose: Notification closed.

Example:

window.addEventListener('AlertWise.onNotificationClick', function (event) {
console.log(event.detail.title);
});

What is the format of the subscriber details response?

The response includes details like subscriber ID, browser, device, timezone, and more. Refer to the ISubscription interface in question 7 for the full schema.

Can I customize the notification behavior?

Yes, use the updateAppConfig method to customize behavior based on specific pages or conditions.

How do I assign segments to subscribers?

Use the segment property during initialization or in the updateAppConfig method to assign segments.

What happens if the SDK encounters an error?

The SDK triggers the onSDKError or onSWError events, allowing you to handle errors gracefully.