Push via Webhook

Webhooks are powerful ways to trigger an action programmatically in other applications. Webhook is nothing but an API call made by a system to some other system. Most of the modern push notification services support an API which can be called to trigger a push notification using their services.

Blueshift’s webhook capabilities for push allow you to connect such push notification service providers or our own custom built solution and trigger push notification from Blueshift’s campaign journey.

Prerequisites

Before you can set up integration with Blueshift, you must have your provider's webhook URL handy.

Set up integration

To send push notifications using the service provider of your choice, simply add your provider's webhook URL to the adapter you create in Blueshift.

To set up integration, complete the following steps:

1. Sign in to the Blueshift app, and click App Hub in the left navigation menu.
2. Go to All Apps, search for, and select Push via Webhook.
3. You can also go to Mobile Marketing Apps and select Push via Webhook.
4. Click Configure to view all the configured adapters.
5. Click +ADAPTER to add an adapter.
6. Add a Name for the adapter.  If you have multiple adapters, the adapter name helps you to identify the integration.
7. Provide the following details for integration:
   

   

   Field	Description
   Webhook URL	Specify the webhook URL for the provider.
   Auth Header	Specify the authentication header for the provider.
   Auth Token	Specify the authentication token for the provider.

8. Click Save to add the adapter. 

Example

Here is an example of the message sent to the webhook when you use this adapter in a campaign Push trigger.

{
  "device_type": "both",
  "apns_tokens": [
  "7a65a21969de1c29c70655e1c42e46f3023ed131fe456747891747e7c5791bf0"
  ],
  "gcm_tokens": [],
  "apns_payload": {
  "aps": {
    "alert": {
      "title": "hiiiii",
      "body": "this is dismiss push url"
      },
    "notification_type": "notification",
    "category": "BuyView-2385243605",
    "mutable-content": 1,
    "interruption-level": "active"
  },
  "actions": [
    {
      "title": "Buy",
      "identifier": "Buy",
      "type": "open",
      "deep_link_url": "blueshift://dismiss"
    },
    {
      "title": "View",
      "identifier": "View",
      "type": "open",
      "deep_link_url": "blueshift://dismiss"
    }
  ],
  "image_url": "https://picsum.photos/id/68/300/300",
  "deep_link_url": "blueshift://dismiss"
  },
  "gcm_payload": {
    "data": {
      "message": {
        "notification_type": "notification",
        "category": "promotion",
        "content_title": "Hello",
        "content_text": "This is a test message. Click me to launch google.com",
        "content_sub_text": "",
        "big_content_title": "Hello",
        "big_content_summary_text": "",
        "notification_channel_name": "",
        "notification_channel_description": "",
        "deep_link_url": "https://google.com?utm_campaign=send-me-push&utm_source=blueshift&utm_medium=push&utm_content=new-push-template"
      }
    }
  },
  "channel": "push",
  "message_uuid": "1843c569-9977-4596-9da9-cf4f84456346",
  "user_uuid": "7815a9bf-99e5-464d-a755-43cb94528cbd",
  "transaction_uuid": "9d2c58c5-9438-4708-812c-6d2f2bc948bd",
  "experiment_uuid": "49425db1-c036-f778-5116-89b00cb3b13b",
  "bsft_tracking": {
    "mid": "1843c569-9977-4596-9da9-cf4f84456346",
    "uid": "7815a9bf-99e5-464d-a755-43cb94528cbd",
    "txnid": "9d2c58c5-9438-4708-812c-6d2f2bc948bd",
    "bsft_ek": "2024-02-08T13:38:07Z",
    "eid": "49425db1-c036-f778-5116-89b00cb3b13b"
  },
  "campaign_name": "send-me-push",
  "campaign_uuid": "4f02525c-80ee-43e8-9d4a-00e5fa29fc2e",
  "trigger_uuid": "30f38ee5-bb8d-45fa-a4a8-e85f351c7654",
  "customer_id": "PROFILEID:test0802@blueshift.com"
}

Next steps

1. Create a Push template or an In-app template for your messages.
2. In your campaign journey, add a Push trigger or In-app trigger. On the Push or In-app tab of the trigger, go to Send Settings and specify Push via Webhook as the App and select the adapter that you just created.
3. To use the Push via webhook app to archive a copy of the message that you send to the user, add the Push or In-app trigger immediately after the messaging trigger (i.e. as a daisy chain) without adding any delay or filter criteria.