API経由でプッシュ通知を送信する

Adalo APIを使用して、iOSまたはAndroidを利用するアプリのユーザーにプッシュ通知を送信します。

スキルレベル: エキスパート

開始前に

• APIを介して通知をトリガーする機能は、TeamプランまたはBusinessプランで利用可能です。

• Adalo APIを介して複数のユーザーに直接通知を送信することはできません。

• 現時点では、ユーザーがどの画面に移動するかを設定することはできません。現時点では、アプリのホーム画面に移動します。

• アプリがXanoバックエンドを使用している場合、ユーザーIDを使用して特定のユーザーをターゲットにする必要があります。

  • ユーザーのすべてのエンドポイントを"As Self"で返す必要があります。

リクエストの設定

cURL

このエンドポイントを素早くテストしたい場合は、次のcurlをコマンドラインから実行してください。データをアプリのデータに置き換えることを忘れないでください！

curl --location 'https://api.adalo.com/notifications' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {Your App API Key}' \
--data-raw '{
  "appId": "{your-app-id}}",
  "audience": { "id": {userID} },
  "notification": {
    "titleText": "Hello There",
    "bodyText": "This is just a test..."
  }
}'

リクエストヘッダー

APIリクエストの基本URLは次のとおりです:

https://api.adalo.com/notifications

以下のヘッダーを含める必要があります:

Authorization: Bearer [Your App's API Key]
Content-Type: application/json

リクエストボディ

APIリクエストで以下を指定する必要があります

• アプリID（Adaloでアプリを編集しているときのURLからApp IDを見つけることができます）

• 受信者のメールアドレスまたはユーザーID

• プッシュ通知のタイトルテキスト

• プッシュ通知の本文テキスト

メールアドレスでターゲット指定

// 例：リクエストボディ（メール）
{
  "appId": "2bc38ea8-2eb1-4db0-974c-e9e031f2c0e0",
  "audience": { "email": "[e-mail]" },
  "notification": {
    "titleText": "Hello There",
    "bodyText": "This is just a test..."
  }
}

ユーザーIDでターゲット指定

// 例：リクエストボディ（ユーザーID）
{
  "appId": "2bc38ea8-2eb1-4db0-974c-e9e031f2c0e0",
  "audience": { "id": "123" },
  "notification": {
    "titleText": "Hello There",
    "bodyText": "This is just a test..."
  }
}

サーバーレスポンス

成功したリクエストは2つのパラメータを返します:

• successful: [count]

• failed: [count]

"Successful"は通知がユーザーのデバイスに配信されたことを意味します。"Failed"はユーザーがもはやアプリにプッシュ通知を送信する権限を与えていないことを意味します。両方が0の場合、通知が送信されたユーザーはまだそのデバイスにアプリをインストールしていないことを意味します。

Adalo APIを使用してスケジュールされたプッシュ通知を送信する方法に関するビデオチュートリアルはこちらです:

通知のトラブルシューティング

通知の問題をトラブルシューティングするためにチェックすることをお勧めするいくつかの要件があります。

通知は、次の場合にのみ送信されます;

1. 送信先の視聴者が存在します（「受信者」と設定されたユーザー）

通知は、以下の条件を満たす場合にのみ受信されます：

1. 受信者がデバイスにアプリをインストールしている場合。

2. 受信者がログインしているか、過去2週間以内にアプリでアクティビティを行っている場合、アクティブと見なされます。

3. 受信者が許可を許可している権限を持っている場合（通知許可）。

4. 受信者が _通知をトリガーするユーザーでない_こと。つまり、ログインしているユーザーが自分自身に通知をトリガーしていないこと。

iOS Nativeで通知が失敗しているがAndroidでは失敗していない場合は、Apple Developerアカウントで通知キーを削除して新しいビルドをプッシュしてください。

ヘルプ

この記事に関する追加のヘルプが必要な場合は、いつでもコミュニティフォーラムで質問できます！投稿にこの記事へのリンクを貼り付けることも忘れずに！

チュートリアルやヘルプドキュメントのリクエストがありますか？お知らせください！