Telegram メッセージの送信コンポーネントは、ジャーニー内で Telegram メッセージを送信します。受信者はメッセージに返信でき、インタラクティブな返信に基づいてジャーニーをブランチできます。
コンポーネント情報
コンポーネントアイコン | コンポーネント名 |
| Telegram メッセージの送信 |
前提条件
このコンポーネントを設定するには、既存のジャーニーを使用するか、新しいジャーニーを作成して、ジャーニーキャンバスにアクセスします。
既存のジャーニーのキャンバスに移動
Agentic Journey のジャーニーリストページで、ジャーニーの右側にある [Edit] をクリックして、キャンバス編集ページに移動します。
新しいジャーニーを作成して、そのキャンバスを開きます。 詳細については、「Agentic Journey の使用」をご参照ください。
操作手順
キャンバスで [Telegram メッセージの送信] コンポーネントアイコンをクリックします。右側にコンポーネント設定エリアが表示されます。
必要に応じてコンポーネントを設定します。詳細については、「設定項目」をご参照ください。
設定を完了したら、ページ上部の保存をクリックします。表示されたダイアログボックスで、[保存]をクリックして操作を完了します。
例
次の例では、インバウンドメッセージにテキストメッセージで返信するようにコンポーネントを設定する方法を説明します。
設定パネルの送信設定エリアで、[Action] を [返信] に設定します。
メッセージ設定エリアで、[Message type] を [Text] に設定し、[Content] フィールドにメッセージ内容を入力します。使用できる変数として、incomingMessage や telegramChatId などがあります。
設定項目
利用可能な変数
[利用可能な変数] エリアには、デフォルトで作成される共通変数が含まれています。これらの変数は、ジャーニーのオーケストレーション中に使用できます。カスタム変数を追加するには、設定ページで [変数を挿入] をクリックします。新しい変数が [利用可能な変数] に表示されます。利用可能な変数の詳しい使用方法については、「利用可能な変数の使用」をご参照ください。
送信設定
[送信設定] で、[From/To] または [返信] のいずれかを選択します。
From/To
トリガータイプが API イベントの場合、[送信設定] で [From/To] を使用する必要があります。
送信タイプ | 説明 |
送信 | メッセージの送信元となるメッセージチャネルと送信者アカウントを選択します。選択するメッセージチャネルは、承認済みであり、アカウントが正しく接続されている必要があります。[受信者] には、フィールドに固定 ID を入力するか、[変数を挿入] をクリックして定義済みの変数を選択するか、変数を追加します。 |
変数 | ドロップダウンリストから変数を選択します。[受信者] には、フィールドに固定 ID を入力するか、[変数を挿入] をクリックして定義済みの変数を選択するか、変数を追加します。 |
返信
[返信] を選択すると、現在のジャーニーに紐付けられている送信者アカウントを使用して、ユーザーのインバウンドメッセージに返信します。追加の設定は不要です。
メッセージ設定
[メッセージ設定] では、送信するメッセージのタイプとして [Text] または [テンプレートメッセージ] のいずれかを選択します。
Text
[Message type] を [Text] に設定すると、プレーンテキストのメッセージが送信されます。メッセージの内容を指定する必要があります。内容には変数を使用できます。
テンプレートメッセージ
[Message type] を [テンプレートメッセージ] に設定した場合、メッセージチャネルと、そのメッセージチャネル用に作成されたメッセージテンプレートを選択します。[Preview] をクリックすると、テンプレート内容をプレビューできます。
タイムアウト設定
[未配信ブランチの有効化] をオンにするかどうかを指定します。このスイッチをオンにすると、タイムアウト期間をカスタマイズし、未配信ブランチのコンポーネントを設定できます。たとえば、タイムアウト期間が経過する前にメッセージが配信されなかった場合、[Send SMS] コンポーネントを使用して SMS でメッセージを送信できます。
インタラクティブな返信設定
設定項目 | 説明 | 例 |
インタラクティブな返信に基づく分岐の有効化 | このスイッチをオンにすると、インタラクティブなメッセージに設定されたボタンまたはリストオプションに基づいて返信ブランチが作成され、各ブランチを設定できます。 | システムは、インタラクティブなメッセージに設定された各ボタンまたはリストオプションに対して自動的に返信ブランチを生成します。各ブランチの後続フローを個別に設定できます。 |
インタラクティブな返信タイムアウトの分岐を有効化 | このスイッチをオンにすると、待機期間が経過した場合に処理するための無返信ブランチが作成されます。インタラクティブな返信を待機するタイムアウト期間をカスタマイズする必要があります。[未配信ブランチの有効化] がオンで、他のフローが設定されていない場合、タイムアウト期間が経過した後、ジャーニーは後続フローに進みます。 | [インタラクティブな返信の待機時間] でタイムアウト期間を設定します。たとえば、90 秒に設定します。 |
インタラクティブな返信の待機時間 | 待機のタイムアウト期間を設定します。秒、分、時間単位で指定できます。指定したタイムアウト期間が経過すると、無返信ブランチの設定が有効になります。 | たとえば、90 秒に設定します。 |
カスタム出力変数名 | ユーザーの選択を格納するカスタム変数を指定します。新しい変数は利用可能な変数リストに表示され、後続フローでいつでも呼び出すことができます。 | たとえば、 |
詳細設定
設定項目 | 説明 |
追跡 ID | 特定のメッセージにマークを付け、メッセージ情報を追跡します。 |