[和訳]ウェルカムメッセージ

公開日:2020/09/10  最終更新日:2020/09/10  カテゴリー:Twitter API

本投稿は、Twitter開発者サイトのドキュメントを和訳したものです。
原文のサイトは、参考文献よりご確認ください。

1. 外観

ウェルカムメッセージは、ダイレクトメッセージに入ってきた人々にメッセージを表示する手段を提供します。
ウェルカムメッセージは、様々な参照パスによってカスタマイズすることが可能です。
例えば、ツイート中のダイレクトメッセージリンクをクリックしたユーザーか、何の脈略もなく初めてダイレクトメッセージの画面に入ってきたユーザーかどうかなどです。
ウェルカムメッセージには、メディアやクイックリプライなど、ダイレクトメッセージと同じような内容を含めることができます。

ウェルカムメッセージは、次の2つの方法でユーザーに提示することができます。

  • デフォルトのウェルカムメッセージの設定
    ユーザーがダイレクトメッセージ画面に入ったときに見る、デフォルトのメッセージを設定する。
  • ウェルカムメッセージへのディープリンク
    ダイレクトメッセージ外面で特定のメッセージにユーザーをリンクするために、どこでも使用できるURLを作成する。

2. 案内

2.1. デフォルトのウェルカムメッセージの設定

デフォルトのウェルカムメッセージがない場合、ユーザには、空のダイレクトメッセージ会話画面または前の会話の状態が表示されます。
ウェルカムメッセージディープリンクが使用されていない時に表示されるように、1つのウェルカムメッセージをデフォルトに設定することができます。
デフォルトのウェルカムメッセージを使用して、ユーザーにどのようなサービスが提供されているか、いつ応答を受け取れるかなどを含めた文脈を提供するか、自動化された会話の流れを開始するためのクイックリプライ選択肢を提供しましょう。
ダイレクトメッセージで利用できるすべての機能は、デフォルトのウェルカムメッセージで使用できます。

ウェルカムメッセージがデフォルトとして設定されている場合、次のような場面でユーザーに表示されます。

  • ダイレクトメッセージ作成画面を初めて開いた。
  • 会話から離れてから初めてダイレクトメッセージ作成画面を開いた。
  • 7 日間メッセージのやりとりが無かった後に、ダイレクトメッセージ作成画面を開いた。
注意
ディープリンクでウェルカムメッセージを指定すると、常にデフォルトのウェルカムメッセージは上書きされます。
ウェルカムメッセージを定義しないディープリンクは、上記で定義されたデフォルトのウェルカムメッセージの動作に従います。

デフォルトメッセージを設定するための手順は、次のとおりである。

注意
1つのアカウントには多くのウェルカムメッセージを持つことができますが、1つのアカウントには1つの「デフォルト」のウェルカムメッセージと1つのルールのみ持つことができます。
もしも以前にルールを作成したことがある場合は、新しいルールを作成する前に現在のルールを削除しなければなりません。
ルールに関する詳細は、POST direct_messages/welcome_messages/rules/newドキュメントを参照してください。

2.2-a. ウェルカムメッセージへのディープリンク

すべてのウェルカムメッセージにディープリンクすることができます。
ユーザーがディープリンクをたどると、ダイレクトメッセージ作成画面が開き、指定されたウェルカムメッセージが表示されます。
ディープリンクは、ウェブサイト、アプリ、ツイート、または他のダイレクトメッセージの会話など、どこからでも使用することができます。

ウェルカムメッセージディープリンクを作成するための手順は、次の通りである。

  • POST direct_messages/welcome_messages/new から、新しいウェルカムメッセージを作成します。 返されたウェルカムメッセージIDをメモしておきます。
  • recipient_id と welcome_message_id クエリ文字列パラメータを定義して、ダイレクトメッセージのディープリンクを作成します。
    例:https://twitter.com/messages/compose?recipient_id= 3805104374&welcome_message_id=12345
注意
ウェルカムメッセージは必要な数だけ作成することができ、すべてのウェルカムメッセージにディープリンクすることができます。

2.2-b. ツイートからのディープリンク

ダイレクトメッセージのリンクURLをツイートの最後に含めるだけで、ツイートの下部に「メッセージで返信」ボタンを追加することができます。
ツイートでのダイレクトメッセージへのリンクの使用についての詳細は、こちらのブログ記事をご覧ください。

ダイレクトメッセージカードを使用すると、企業は魅力的な画像や創造的な動画で人々の注意を引きつけ、最大4つの完全にカスタマイズ可能な動作呼び出しボタンを追加することができます。
各動作呼び出しボタンは、ユニークなウェルカムメッセージにディープリンクすることができます。
現在、ダイレクトメッセージカードはTwitter広告主向けに限定ベータ版として提供されています。
詳細については、Twitterの営業担当者にお問い合わせください。

2.2-c. ウェブサイトからのディープリンク

ダイレクトメッセージのディープリンクは、ウェブサイトやモバイルアプリなどの外部ソースからのディープリンクにも使用できます。
ウェブサイトからのウェルカムメッセージへのディープリンクの詳細については、メッセージボタンのドキュメントを参照してください。

3. 参考文献

本サイトでは URLに日本語を含んでいます。
メールなどで共有する場合は リンクとして認識されない場合がございますので、こちらをご利用ください。