PUSH NOTIFICATIONS API

NotifyVisitors API endpoints enable you to send push notifications to the users to nudge them to perform an action on your site. You can send the notifications to all the subscribers, or a specific user, or any segment.

You can call on the below API to send push notifications to the users.

📘

https://push.notifyvisitors.com/api/v1/

API ENDPOINTS FOR DIFFERENT PLATFORMS

NotifyVisitors provides different API Endpoints for different platforms :

Web

  • Send push notifications to the users anywhere and anytime using different API endpoints across the web platforms and devices.
    https://push.notifyvisitors.com/api/v1/web/

Android

  • Send push notifications to the users on their android and mobile devices using API endpoints.
    https://push.notifyvisitors.com/api/v1/android/

IOS

  • Send notifications on ios devices to the users via different API endpoints provided by NV.
    https://push.notifyvisitors.com/api/v1/ios/

📘

NOTE :

You can send the push notifications on all these platforms to an individual, to a particular segment, or to all the subscribers

API ENDPOINTS FOR DIFFERENT SEGMENTS:

To Individual User

  • You can send notifications to the individual subscribers on the basis of their subscriber ID or User ID via the below API endpoint

https://push.notifyvisitors.com/api/v1/web/send

You have to send the post parameters such as title, message, URL of the notification of an individual subscriber to an API endpoint. Read below for more information.

To All The Subscribers

  • Call the below API endpoint to send notifications to all the subscribers.

https://push.notifyvisitors.com/api/v1/android/broadcast/all

The title, message, URL of the notification, and image have to be sent as the post parameters to the API endpoint.

To A Particular Segment

  • Call the below API endpoint to send notifications to subscribers of a particular
    segment.

https://push.notifyvisitors.com/api/v1/web/broadcast/segment

Title message, URL of the notification have to be sent as the post parameters to the API endpoint.

API RATE LIMIT

  • The API rate limit is the number of time the API can be requested per minute.
  • You can make up to 500 API requests per minute on an API.
  • If the limit exceeds, the app will throw error in Response. All API requests are subject to rate limits.

PASS THE PUSH VARIABLES AS PARAMETERS IN REQUEST BODY:

See the below example

curl --request POST \
  --url https://push.notifyvisitors.com/api/v1/web/send \
  --header 'accept: application/json' \
  --header 'content-type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'x-brand-id: YOUR_BRAND_ID'\
  --data '{"user_id / subscription_id":"1234",
  "notification_id":3456,
  "title":"RATING FEEDBACK",
  "message":"TEST PUSH",
  "url":"https://www.notifyvisitors.com/"
  	}'

📘

Note :

  • Replace YOUR_API_KEY with NotifyVisitors' API key.
  • Replace YOUR_BRAND_ID with NotifyVisitors' Brand id .
  • You can select parameters from the given table on the right to send user attributes in request body.
PARAMETERSTYPEDESCRIPTION
User id/subscription idstringUnique identification ID of the user
Notification idint64Unique Id that is assigned to the users
tagstringTags are assigned to the users to segment them on the basis of certain factors
Time-Number of seconds after which you want to send the notification.
TitlestringMaximum character limit for the title
URLstringCall to action URL
Image _URLstringImage URL must be on HTTPs URL
Hero_image URLstringURL needs to be on HTTPs. Works only for chrome subscribers
Button_one titlestringMaximum length of the call-to-action button, works only for chrome subscribers
Button_two titlestringAllowed only in chrome version and above
Button_two URLstringWorks only for chrome subscribers
segment_IDint_64Unique segment ID
Schedule _datestringDate scheduled for sending push
Schedule_timestringTime scheduled for sending push
TimezonestringTime zone (default value 0)
Hero_image URLstringURL needs to be on HTTPs. Works only for chrome subscribers