Integrating Batch into your website is simple. After a 20 minute setup, you will be able to push them directly from your website, without making them install your app. And just like native applications, you can send push notifications with images, and more!

1. Account Creation

You can create an account now on https://batch.com/register.

We recommend you to invite your team members from the account manager section, in the bottom left corner of your dashboard, in "My team" → "Add member". Once your account is created, add your website to the dashboard.

2. Basic Setup

Step 1. Upload the service worker (optional)

If all your content is served via the same HTTPS domain, then you must upload Batch's Service Worker to the root of your website.

Step 2. Add the javascript tag 

Add Batch's javascript tag to the code of your web pages. This can be done manually or using a tag manager (e.g. Google Tag Manager, Tag Commander, etc).

Batch automatically generates that javascript tag when you add your website on the dashboard:

Step 3. Test your integration

That's it! You should see a push permission prompt next time you visit your website. We recommend you try sending a test notification to your browser after accepting push notifications. More information here: how to send a test push

In case you don't see the permission prompt, make sure:

  • Staging domain name: If you deployed Batch on a staging version of your website, make sure your javascript tag contains the "dev : true" parameter and you added your staging domain name to the list of "Allowed dev origins", from the dashboard settings > Push settings.
  • Dev mode: If you deployed Batch in production, make sure your removed the "dev : true" parameter from the javascript tag.

3. Optional Optimizations

Opt-in Scenario

To maximise the chances that your users subscribe to notifications, we built multiple ways of asking for permission (know more here).

You can choose between three different formats:

  • An alert (default)
  • A banner
  • A button

In case you don't want to use Batch's formats, you can trigger the native prompt of each browser. That permission request can be shown 3 times a week (more information here).

Custom User ID

Batch can collect a unique user ID (see documentation) that will be attached to your user installation. This is a recommended step if your website has a login wall or if users can create an account on your website.

You can use that Custom user ID with:

  • The Transactional API, to send 1-to-1 push notifications to one or several user IDs (e.g. package delivery notification, etc) ;
  • The Custom Data API, to send custom data (attributes or tags) to Batch on a user ID server-side.

User ID collection also allows your teams to:

  • Target logged in / logged out users (see has custom user ID)
  • Upload static segments exported from your userbase (e.g. top 500 buyers, etc) or created by third-party tools (see custom audiences)

Custom Language/Region

Batch automatically detects the language and the country of your users’ browser. If users can select a region or a language from your website, we recommend you overwrite the values automatically detected by Batch (see documentation).

4. Optional APIs Setup

With Batch RESTful APIs you can easily send custom data and push notifications to take advantage of Batch’s advanced features from your own systems. There are basically three APIs you can use in your app to cover all your marketing needs:

  • The Custom Data API to send custom data on specific custom user IDs and improve your campaign targetings.
  • The Transactional API allows you to send notifications to a specific token or custom user ID based on events in your back-end (e.g. "You have a new friend request").
  • The Campaigns API allows you to send push notifications in mass to your segments (attributes, events) or to segments generated by Batch (country/language, dormant users, app version, etc).

Depending on the use cases you plan to set up, we can help you through the use of these APIs.

Need Assistance?

Our technical team is reachable via the “live chat” in the bottom right corner of every page of the dashboard (median response time lower than 3 minutes from 9 am to 7 pm on working days).

Did this answer your question?