​

Apple Push Notification (.p8) Setup Guide

Purpose: Get Apple Push Notification credentials for Intercom push notifications
Required: Apple Developer account access
Time: ~5 minutes

---

​

Step-by-Step Guide

​

Step 1: Access Apple Developer Account

1. Go to Apple Developer Portal
2. Sign in with your Apple Developer account credentials
3. If you don’t have an account, you’ll need to enroll ($99/year)

​

Step 2: Navigate to Keys Section

1. In the left sidebar, click “Certificates, Identifiers & Profiles”
2. Click “Keys” in the left sidebar
3. You’ll see a list of existing keys (if any)

​

Step 3: Create New APNs Key

1. Click the ”+” button (top left, next to “Keys”)
2. You’ll see a form to create a new key

​

Step 4: Configure the Key

1. Key Name: Enter a descriptive name (e.g., “Sanctiv Push Notifications” or “Intercom APNs Key”)
   • This is just for your reference
   • Can be changed later if needed
2. Enable Services: Check the box for “Apple Push Notifications service (APNs)”
   • ⚠️ Important: Only check APNs, don’t check other services unless needed
   • Other services aren’t needed for push notifications
3. Click “Continue” button

​

Step 5: Review and Register

1. Review the key configuration
2. Click “Register” button
3. ⚠️ CRITICAL: You’ll see a confirmation screen

​

Step 6: Download the .p8 File

1. ⚠️ IMPORTANT: You can only download the .p8 file ONCE
   • After you leave this page, you cannot download it again
   • If you lose it, you’ll need to create a new key
2. Click “Download” button
   • The file will be named something like AuthKey_XXXXXXXXXX.p8
   • Save it somewhere safe (e.g., password manager, secure folder)
3. ⚠️ DO NOT CLOSE THIS PAGE YET - You need to copy the Key ID first!

​

Step 7: Copy Key ID

1. On the same page, you’ll see “Key ID”
   • It looks like: ABC123DEF4 (10 characters, alphanumeric)
   • Copy this value - you’ll need it for Intercom
2. Save the Key ID somewhere safe (same place as the .p8 file)

​

Step 8: Get Your Team ID

1. Look at the top right of the Apple Developer portal
2. You’ll see your Team ID (or click your name/team name)
   • It looks like: ABCD1234EF (10 characters, alphanumeric)
   • This is your Apple Developer Team ID
3. Save the Team ID somewhere safe

​

Step 9: Verify You Have Everything

Before leaving the Apple Developer portal, make sure you have:

• ✅ .p8 file downloaded and saved securely
• ✅ Key ID copied (10 characters)
• ✅ Team ID copied (10 characters)
• ✅ Bundle ID (from your app: com.sanctiv.app)

---

​

What You’ll Need for Intercom Dashboard

When configuring Intercom push notifications, you’ll need:

1. App name: Sanctiv
2. Bundle ID: com.sanctiv.app
3. .p8 file: Upload the downloaded file
4. Key ID: Paste the 10-character Key ID
5. Apple Team ID: Paste your Team ID

---

​

Security Best Practices

​

✅ DO:

• Store .p8 file in a password manager or secure vault
• Keep Key ID and Team ID with the .p8 file
• Use descriptive key names for easy identification
• Create separate keys for different apps/environments if needed

​

❌ DON’T:

• Commit .p8 file to git (it’s already in .gitignore)
• Share .p8 file publicly
• Delete the key from Apple Developer (you’ll lose access)
• Create multiple keys unnecessarily (you’re limited to a certain number)

---

​

Troubleshooting

​

”I lost my .p8 file”

• Solution: Create a new APNs key in Apple Developer portal
• Note: You’ll need to update Intercom with the new Key ID and upload the new .p8 file
• Prevention: Store in password manager or secure backup

​

”I can’t find my Team ID”

• Solution: Look at top right of Apple Developer portal, click your name/team
• Alternative: Check any existing certificates/keys - Team ID is shown there

​

”Key ID is missing”

• Solution: If you already closed the key creation page, check the Keys list
• The Key ID is shown in the list (but you can’t download .p8 again)

​

“I see multiple Team IDs”

• Solution: Use the Team ID associated with your app’s Bundle ID
• Check your app’s App Store Connect or Xcode project settings

---

​

Next Steps

After obtaining the .p8 file and credentials:

1. Go to Intercom Dashboard → Settings → Channels → Messenger → Install
2. Scroll to “Setup push notifications” section
3. Fill in the form with your credentials
4. Upload the .p8 file
5. Test push notifications

See docs/dev/INTERCOM.md for complete Intercom setup instructions.