VoIPプッシュ通知

• Apple PushKitを使用してアプリでVoIPトークンを登録する
• VoIP Services Certificateを使用した専用のOneSignalアプリを作成する
• OneSignal REST APIを通じてトークンを登録し、プッシュを送信する

​

プラットフォームの違い

​

iOS：VoIPプッシュ通知を送信する

1

PushKitを使用してVoIPトークンを登録する

AppleのPushKitフレームワークを使用してVoIP通知に登録し、VoIPトークンを受け取ります。

• アプリにPushKitを実装する
• AppleがローテーションするときにVoIPトークンを保存して更新する
• AppleのVoIPポリシーに厳密に従う

例：PushKitデリゲートの実装

import PushKit

class AppDelegate: NSObject, PKPushRegistryDelegate {
    func registerForVoIPPushes() {
        let registry = PKPushRegistry(queue: .main)
        registry.delegate = self
        registry.desiredPushTypes = [.voIP]
    }

    func pushRegistry(_ registry: PKPushRegistry, didUpdatePushCredentials credentials: PKPushCredentials, for type: PKPushType) {
        let token = credentials.token.map { String(format: "%02x", $0) }.joined()
        // このトークンをOneSignalに渡します — ステップ4を参照
    }
}

これは標準のApple PushKitコードです。OneSignalはPushKit SDKを提供していません — トークンをご自身で登録し、ステップ4でOneSignalに渡します。

Appleのリソース：

• PushKitドキュメント
• VoIPプッシュへの応答
• AppleのVoIPベストプラクティス

2

VoIP用の別個のOneSignalアプリを作成する

Apple VoIPプッシュは標準のプッシュ通知とは異なる証明書タイプを必要とします。1つのOneSignalアプリは1種類の証明書しか使用できないため、2つの別個のOneSignalアプリを作成する必要があります：

• メインプッシュアプリ：標準のプッシュ通知用のAPNs証明書を使用
• VoIPプッシュアプリ：VoIP専用の通知用のVoIP Services Certificateを使用

両方のアプリは同じiOS Bundle IDを使用し、同じネイティブiOSアプリに関連付けられている必要があります。OneSignal SDKを2回初期化する必要はありません — VoIPアプリはAPIを通じてVoIPプッシュを送信するためにサーバーサイドのみで使用されます。

Bundle ID（例：com.yourcompany.appname）は、XcodeのターゲットのGeneralタブで確認できます。

3

VoIP Services Certificateをアップロードする

VoIP OneSignalアプリで、**VoIP Services Certificate（.p12）**をアップロードします。これは通常の通知に使用する標準のAPNsプッシュ証明書とは異なる証明書タイプです。作成手順：

1. Apple Developer Portalにアクセスする
2. VoIP Services Certificateを選択する
3. 画面の指示に従って証明書を生成してダウンロードする
4. Keychain Accessで開き、.p12ファイルとしてエクスポートする
5. VoIP OneSignalアプリのiOS設定に.p12ファイルをアップロードする

VoIPアプリに標準のAPNsプッシュ証明書をアップロードしないでください。間違った証明書タイプを使用すると、APIはプッシュリクエストを受け付けますが、Appleがそれを拒否し、通知が届きません。

4

OneSignalにVoIPトークンを登録する

Create User APIを使用して、VoIP OneSignalアプリにVoIPトークンを登録します。

サンドボックス/開発ビルドには"test_type": 1が必要です。 このフィールドを省略すると、API呼び出しは成功してエラーも返されませんが、Appleはトークンをプロダクション用として扱い、送信されたすべてのプッシュをサイレントに拒否します。

curl --request POST \
     --url https://api.onesignal.com/apps/YOUR_VOIP_APP_ID/users \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "subscriptions": [
    {
      "type": "iOSPush",
      "token": "YOUR_VOIP_TOKEN",
      "test_type": 1
    }
  ]
}
'

有効なVoIPトークンは64文字の小文字16進数文字列です（例：a1b2c3d4e5f6...）。PushKitはiOSシミュレーターでは動作しません — 有効なトークンを取得するには実機を使用する必要があります。

後でトークンを更新するには、Update Subscription APIを使用します。

5

VoIP通知を送信する

Create Notification APIを使用し、以下のパラメータを指定します：

• "apns_push_type_override": "voip" — これがVoIPプッシュであることをAppleに通知する
• app_id — VoIPアプリのID
• include_subscription_ids — 登録したVoIPサブスクリプションID
• contentsまたはcontent_availableのいずれかが必要

curl --include \
     --request POST \
     --header "Content-Type: application/json; charset=utf-8" \
     --header "Authorization: key YOUR_REST_API_KEY" \
     --data-binary '{
  "app_id": "YOUR_VOIP_APP_ID",
  "content_available": true,
  "data": {
    "your_custom_data": "your_custom_value"
  },
  "apns_push_type_override": "voip",
  "include_subscription_ids": ["YOUR_VOIP_SUBSCRIPTION_ID"]
}' \
https://api.onesignal.com/notifications

6

VoIPセットアップを確認する

以下の場合、iOS VoIP統合は正しく機能しています：

1. VoIPアプリでVoIPトークンがiOSプッシュサブスクリプションとして表示される
2. VoIPプッシュがアプリ内のpushRegistry(_:didReceiveIncomingPushWith:for:completion:)をトリガーする
3. アプリが終了またはバックグラウンドの状態でもウェイクアップされる

​

Android：VoIPスタイルの動作をシミュレートする

• データのみのプッシュ通知
• フォアグラウンドサービス
• カスタム通話スタイルのUI

• データのみの通知を送信する
• アプリ内でそれらを処理して：
  • フォアグラウンドサービスを開始する
  • 通話UIアクティビティを起動する
  • カスタムの着信通知を表示する

• Android通話アプリガイド
• 着信UIの例

​

よくある質問

​

確認済み配信はVoIPで機能しますか？

pushRegistry(_:didReceiveIncomingPushWith:for:completion:)

​

OneSignalダッシュボードからVoIP通知を送信できますか？

​

VoIPプッシュがサイレントに失敗するのはなぜですか？

1. サンドボックス/開発ビルドを使用していますか？ Create User APIでトークンを登録する際に"test_type": 1を含める必要があります。これを省略すると、トークンがプロダクション用として登録され、Appleがプッシュを拒否してサイレントに失敗します。
2. 正しい証明書をアップロードしましたか？ VoIP OneSignalアプリは標準のAPNsプッシュ証明書ではなく、**VoIP Services Certificate（.p12）**を使用する必要があります。Keychain Accessでは両方が似て見えますが、証明書名が「VoIP Services」で始まることを確認してください。
3. 正しいOneSignalアプリに送信していますか？ 送信リクエストのapp_idはメインのプッシュアプリではなく、VoIPアプリのものである必要があります。REST API KeyもVoIPアプリのものを使用する必要があります。
4. VoIPトークンは有効ですか？ アプリの再インストールやデバイスの復元時にトークンが失効します。トークンが64文字の小文字16進数文字列であり、最近登録されたものであることを確認してください。
5. アプリはreportNewIncomingVoIPPushPayloadを呼び出していますか？ iOS 13以降、AppleはVoIPプッシュを受信したがCallKitに通話を報告しないアプリを終了します。これはOneSignalの制限ではなく、Appleの要件です。

​

関連ページ