> ## Documentation Index
> Fetch the complete documentation index at: https://moengage.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# ✳️ Additional Channels

*(連携で MoEngage の Connector Campaigns を使用して、音声、ダイレクトメール、カレンダーイベントなどのために API エンドポイントにデータを送信する場合は、この例を使用してください。)*

#### **\[Partner Name] と MoEngage の連携**

**作成者**: \[Your Company Name]\
**最終更新日**: \[Date]

*(貴社と事業内容について、2～3 文で簡潔に紹介してください。次に、MoEngage との連携の中核となる価値提案を説明してください。共通の顧客にとって、どのような重要な課題を解決しますか?)*

**パートナー名**: \[Partner Name]\
**パートナーカテゴリー**: Additional Channels

# 概要 🚀

*(連携の中核となる機能を説明してください。マーケターが MoEngage のセグメンテーションとキャンペーントリガーを使用して貴社プラットフォームの API にデータを送信し、音声通話の発信、はがきの郵送、カレンダーイベントの作成などのアクションを開始する方法を説明してください。)*

MoEngage と **\[Partner Name]** の連携により、MoEngage の Connector Campaigns を使用して、当社のプラットフォーム上でリアルタイムの自動アクションをトリガーできます。MoEngage から **\[Partner Name]** の API にユーザーデータとイベントデータを送信することで、マーケターは統合されたカスタマージャーニーの一環として、音声、ダイレクトメール、カレンダーイベントなどの追加チャネルでキャンペーンをシームレスに展開できます。

これにより、ユーザーの行動に基づいて独自性が高くインパクトのあるチャネルでユーザーにエンゲージでき、従来のデジタルメッセージを超えてマーケティングオートメーションを拡張できます。

# ユースケース 🎯

*(この連携でユーザーが実現できる主な内容を 2～3 件挙げてください。具体的かつ行動指向で記述してください。)*

* **自動音声通話によるリマインダーの送信**: MoEngage でイベントベースのコネクターキャンペーンをトリガーし、予約のリマインダーや注文の最新情報について **\[Partner Name]** 経由で自動音声通話を発信します。
* **プロモーション用はがきの郵送**: ユーザーが MoEngage の「High-Value Customer」セグメントに入ったときに **\[Partner Name]** への Webhook をトリガーし、特別オファーを記載したパーソナライズされたダイレクトメールのはがきを自動的に送付します。
* **動的なカレンダーイベントの作成**: ユーザーがチケットを購入した後、MoEngage から **\[Partner Name]** にイベントの詳細を送信して、パーソナライズされたカレンダーイベントを作成し、ユーザーのカレンダーに追加します。

# 前提条件 ✅

* 有効な **MoEngage アカウント**。
* 有効な **\[Partner Name] アカウント**。
* **\[Partner Name]** ダッシュボードから取得した API 認証情報。たとえば次のものです。
  * `API Key` と `API Token` または `Secret`
  * `Account SID` または `Account ID`
  * API エンドポイントに必要なその他の識別子。

# 連携の設定 🛠️

*(これは最も重要なセクションです。2 部構成のガイドにしてください。まず、貴社プラットフォームから必要な認証情報を取得する方法、次に、貴社の API を呼び出すように MoEngage で Connector Campaign を設定する方法です。具体的な例とスクリーンショットを提供してください。)*

## ステップ 1: \[Partner Name] から API 認証情報を取得する

*(ユーザーがダッシュボードのどこで API エンドポイント URL、API キー、その他の必要な認証情報を確認できるかについて、明確なステップバイステップの手順を提供してください。**スクリーンショットの掲載を強くお勧めします。**)*

1. **\[Partner Name]** ダッシュボードにログインします。
2. **API Settings** または **Developer** セクションに移動します。
3. 次の情報を見つけてコピーします。
   * **API Key / App ID:** *\[確認場所を説明してください]*
   * **API Token / Secret:** *\[確認場所を説明してください]*
   * **Account SID / Identifier:** *\[確認場所を説明してください]*

## ステップ 2: MoEngage で Connector Campaign を設定する

1. MoEngage UI の左側のナビゲーションメニューで、**Create Campaign** > **Connectors** > **Custom** に移動します。
2. 配信タイプ (イベントトリガー、スケジュールなど) を選択し、キャンペーン作成の 2 番目のステップ (「Webhook」) に進みます。
3. 貴社プラットフォームへの API 呼び出しを設定します。

| フィールド | 設定手順 | 例 |
| :- | :- | :- |
| **Webhook URL** | API エンドポイントを入力します。エンドポイントで必要な場合は、`{{...}}` 構文を使用して URL に動的データ (User ID や Account Code など) を含めます。 | `https://api.partner.com/v1/send-voice-call` |
| **Method** | 適切な HTTP メソッドを選択します。 | `POST` |
| **Headers** | 認証とコンテンツタイプに必要なヘッダーを追加します。*(正確なヘッダーキーを記載し、特に Basic 認証の場合は値の形式を説明してください。)* | **Key:**`Authorization`<br />**Value:**`Basic <ENCODED_KEY>`<br />**Key:**`Content-Type`<br />**Value:**`application/json` |
| **Body** | **Raw** を選択し、API に必要な完全な JSON ペイロードを指定します。MoEngage のパーソナライズ構文 (`{{UserAttribute['...']}}` または `{{EventAttribute['...']}}`) を使用して、動的なユーザーデータやイベントデータを送信します。***重要***\*: 主要なユースケースについて、コメントを十分に付けた実践的な JSON の例を提供してください。)\* | 以下のペイロードの例を参照してください。 |

### JSON ペイロードの例

MoEngage のパーソナライズ構文 (`{{UserAttribute['...']}}`) を使用して動的データを送信します。

```json wrap theme={null}
{
// The mobile number of the user to call
 "to": "{{UserAttribute['Mobile Number']}}",
// The Caller ID configured in your Partner account
 "from": "18005551234",
// The message to be read out, personalized with user's name
 "message": "Hello {{UserAttribute['First Name']}}, this is a reminder for your appointment tomorrow.",
// Unique identifier for the transaction
 "transaction_id": "{{EventAttribute['appointment_id']}}"
}
```

4. テスト機能を使用してエンドポイントにサンプルリクエストを送信し、設定を確認します。テストが成功すると、200 OK レスポンスが返されます。
5. 検証が完了したら、コネクターキャンペーンを公開できます。

# **トラブルシューティングとよくある質問❓**

*(ユーザーが直面する可能性のある一般的な問題とその解決策を 2～3 件挙げてください。)*

*例:*

## 問題

**問題の例:** Connector のテストが 401 Unauthorized エラーで失敗する。

* **認証ヘッダーを確認する**: `Authorization` ヘッダーの形式が正しいことを再確認してください。Basic 認証を使用している場合は、キーとシークレットが結合され、正しく Base64 エンコードされていることを確認してください。API Key と Secret が正しく、有効期限が切れていないことを確認してください。

## よくある質問

<AccordionGroup>
  <Accordion title="MoEngage からの API 呼び出しが成功したかどうかを確認するにはどうすればよいですか?">
    **\[確認場所を指定してください]**。例: 「**\[Partner Name]** ダッシュボードの「API Logs」または「Developer」セクションで API 呼び出しログを表示すると、MoEngage からの受信リクエストと対応するステータスを確認できます。
  </Accordion>

  <Accordion title="API にレート制限はありますか?">
    **\[API のレート制限の詳細を記載してください]**。例: 「はい、当社の API には 1 分あたり 100 リクエストのデフォルトのレート制限があります。より高い制限が必要な場合は、サポートチームにお問い合わせください。
  </Accordion>

  <Accordion title="問題が解決しない場合は誰に問い合わせればよいですか?">
    API エラー、認証、または当社プラットフォームでのアクションの失敗に関する問題については、**\[Partner Support Email/Link]** から当社のサポートチームにお問い合わせください。MoEngage のキャンペーン設定、セグメンテーション、またはパーソナライズ構文に関する問題については、MoEngage のカスタマーサクセスマネージャーにお問い合わせください。
  </Accordion>
</AccordionGroup>

# **サポート 🤝**

* **\[Partner Name]** に関する問題については、`[Partner Support Email or Link to Support Portal]` から当社のサポートチームにお問い合わせください。
* MoEngage プラットフォームに関する問題については、MoEngage サポートチームにお問い合わせください。