You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/engage/campaigns/push-notifications.md
+43-7Lines changed: 43 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,12 +5,18 @@ plan: engage-premier
5
5
6
6
This page walks you through the process of setting up mobile push notifications using Segment, Twilio, and Firebase/Apple Developer.
7
7
8
-
## Before you begin
9
-
10
-
Push notifications in Engage rely on several dependencies. This page provides a high-level overview of the steps required to set up these dependencies and links to the documentation you'll need to follow to complete setup and configuration.
8
+
> info "Before you begin"
9
+
> Push notifications in Engage rely on several dependencies. This page provides a high-level overview of the steps required to set up these dependencies and links to the documentation you'll need to follow to complete setup and configuration.
11
10
12
11
## Overview
13
12
13
+
You'll set up push notifications in four steps:
14
+
15
+
1.[Set up analytics for push notifications](#1-set-up-analytics-for-push-notifications)
16
+
2.[Add the Engage SDK plugin](#2-add-the-engage-sdk-plugin)
4.[Configure push notifications in Engage](#4-configure-push-notifications-in-engage)
19
+
14
20
## 1. Set up analytics for push notifications
15
21
16
22
Before you can send push notifications, you'll need to set up analytics to track user interactions. In this step, you'll integrate Segment's mobile SDK into your app.
@@ -60,7 +66,7 @@ Follow these steps to integrate the React Native library:
60
66
61
67
For detailed instructions on integrating Analytics for React Native, follow the steps in the [Analytics for React Native started section](/docs/connections/sources/catalog/libraries/mobile/react-native#getting-started).
62
68
63
-
## Add the Engage SDK Plugin
69
+
## 2. Add the Engage SDK Plugin
64
70
65
71
Next, you'll add the Engage SDK Plugin to your application.
66
72
@@ -71,13 +77,43 @@ These are the high-level steps required to add the Engage Plugin for iOS:
71
77
1. Add the Engage SDK Plugin dependency in your `package.swift` file or using Xcode's Swift packages.
72
78
2. Add or modify the methods in the [Additional setup section](https://github.com/segment-integrations/analytics-swift-engage#additional-setup){:target="_blank"} of Segment's Twilio Engage Plugin documentation.
73
79
74
-
The previous steps are required. For detailed instructions on adding the Engage SDK Plugin for iOS, as well as for configuration options, follow the steps in the [getting started section](https://github.com/segment-integrations/analytics-swift-engage#additional-setup){:target="_blank"} of Segment's Twilio Engage Plugin documentation on GitHub.
80
+
The previous steps are required. For detailed instructions on adding the Engage SDK Plugin for iOS, as well as for configuration options, follow the steps in the [getting started section](https://github.com/segment-integrations/analytics-swift-engage#getting-started){:target="_blank"} of Segment's Twilio Engage Plugin documentation on GitHub.
75
81
76
82
77
83
### Instructions for Android
78
84
79
-
1. Follow the instructions in the [getting started section](https://github.com/segment-integrations/analytics-kotlin-engage#getting-started){:target="_blank"} of Segment's Twilio Engage Destination documentation on GitHub.
85
+
Follow the instructions in the [getting started section](https://github.com/segment-integrations/analytics-kotlin-engage#getting-started){:target="_blank"} of Segment's Twilio Engage Destination documentation on GitHub.
86
+
87
+
88
+
## 3. Configure push credentials
89
+
90
+
In this step, you'll configure your iOS and Android push credentials for use with Twilio Notify and Twilio Notifications.
91
+
92
+
### Configure iOS push notifications
93
+
94
+
Follow the steps in Twilio's [How to Configure iOS Push Notifications documentation](https://www.twilio.com/docs/notify/configure-ios-push-notifications){:target="_blank"}.
95
+
96
+
### Configure Android push notifications
97
+
98
+
Follow the steps in Twilio's [Configuring Android Push Notifications](https://www.twilio.com/docs/notify/configure-android-push-notifications){:target="_blank"}.
99
+
100
+
During Step 5, [Upload your API Key to Twilio](https://www.twilio.com/docs/notify/configure-android-push-notifications#step-5-upload-your-api-key-to-twilio){:target="_blank"}, follow these steps:
101
+
102
+
1. In the Firebase console, click the **Cloud Messaging** tab.
103
+
2. Select the three dots menu next to **Cloud Messaging API (Legacy) Disabled**, then select **Manage API in Google Cloud Console**. A new window opens.
104
+
3. In the new Cloud Messaging window, select **Enable**
105
+
4. Return to the Firebase Cloud Messaging tab and refresh the page.
106
+
5. Cloud Messaging API (Legacy) is now enabled. Copy the server key; you'll need it later.
107
+
108
+
With your server key copied, finish steps 5 and 6 in the Twilio documentation.
109
+
110
+
## 4. Configure push notifications in Engage
111
+
112
+
> success ""
113
+
> If you've already configured SMS services for Twilio Engage, you can skip this setp.
80
114
115
+
To set up push notifications in Twilio Engage and complete push notifications onboarding, follow the steps in the [Create and configure Twilio SMS services documentation](/docs/engage/onboarding/#stage-3-create-and-configure-twilio-sms-services).
81
116
82
-
## Configure Firecloud/Firebase or Apple Developer
117
+
## 5. Build a mobile push template
83
118
119
+
Now that you've completed push notifications setup, you're ready to [build a mobile push template](/docs/engage/content/mobile-push/).
0 commit comments