記事テンプレート

一般

開発者アカウントを有効にするにはどうすればよいですか？

APIや関連機能にアクセスするには、まず開発者アカウントを有効にする必要があります。詳しくは個人情報の設定をご覧ください。

Social Connect APIの使用方法を教えてください。

クアルトリクス ソーシャルコネクトAPIのステップバイステップガイドをご覧ください。

Social Connect APIを使用するにはどのようなアカウントが必要ですか？

APIへのアクセシビリティは、すべての料金プランに含まれているわけではありません。ライセンスに含まれる内容についてご不明な点がある場合は、サポートまで連絡先。

プログラミング言語xのクライアント・ライブラリはありますか？

クアルトリクスはクライアントライブラリを提供していませんが、OAuthプロトコル用のライブラリはほぼすべての言語に存在します。http://oauth.net/code/。

apiをすぐにテストできますか？

APIコンソールからAPIをテストすることができます。ここでエンドポイントを選び、必要なパラメータを入力する。結果がすぐに表示され、apiが希望の結果をもたらしたかどうかを確認できます。

apiレートの制限を増やすことはできますか？

APIレート制限の概要については、レート制限を参照してください。現在のレート制限は、標準的なユースケースには十分すぎるほどだ。ただし、追加料金の制限が必要な場合は、連絡先にアプリケーションの使用例と要求される料金制限を説明してください。

フィルタはAPIでどのように機能するのですか？

Social Connect APIのいくつかのエンドポイントでは、フィルター文字列パラメーターを渡すことができます。

例えば、あなたが言及のリストをフェッチしているとします。特定のタグを持つメンションだけが返されるように、メンションをフィルタすることができます。

フィルター・パラメーターは常に文字列である。そのシンタックスは、データのいくつかのプロパティ（言及された単語、タグ、ステータス、解決時間など）を検索し、ブーリアンとネストされたシンタックスを使用してそれらを組み合わせることをサポートしています。

ソーシャルコネクトプラットフォームでフィルターを作成すると、フィルターに関連するテキスト表現があります。この表示は、フィルター・フィールドを選択した後、フィルター・ウィンドウに表示されます。このパラメータをコピーして、APIコールで使用することができる。

ウェブフックの署名にはどのような方法がありますか？

詳しくはWebhooksをご覧ください。

APIコールのレートが1時間あたり20回に制限されているのはなぜですか？

API Consoleを使用する場合、レート制限は、他のAPIクライアントの標準的な1時間あたり350コールではなく、1時間あたり20認証機能コールとなります。この20コール制限が発生する場合は、APIコンソールではなく、APIアプリケーションのアクセストークンを使用していることを確認してください。

API認証機能

APIコールはどのように認証されますか？

クアルトリクスは標準的なOAuth 2.0プロトコルを使用しています。詳しくは認証機能を参照。

自分のアプリケーションにOAuthを実装する必要が本当にあるのか？

アプリケーションのユーザーにクアルトリックスのソーシャルコネクトアカウントを認証させる必要がない場合は、代わりに自分のユーザーアカウントのOAuthトークンを生成することができます。アプリケーションの概要に移動し、登録したアプリケーションの次へ[編集]をクリックし、[アクセシビリティ]タブに移動します。Authorise Myselfをクリックすると、現在ログインしているユーザー（そのアクセシビリティを持つ）のアクセストークンが生成されます。このアクセストークンを使用して、Apiリクエストに署名することができます。

アクセシビリティトークンの検証期間は？

詳しくは認証機能のページをご覧ください。

トークンでアクセスできるアカウントやデータは？

OAuthアクセストークンは、特定のSocial Connectユーザー用に生成されます。このユーザは1つ以上のアカウントにアクセシビリティを持っています（どのアカウントかは `/me/accounts` エンドポイントから確認できます）。どのようなデータにアクセスできるかは、そのユーザー自身がどのアカウントにアクセシビリティを持っているか、そのアカウントでのユーザーロールが何であるかによって決まります。

言及を伴う作業

Social Connectの受信トレイから自分のアプリケーションにメンションを取り込むにはどうすればいいですか？

account_id}/inbox/mentions`エンドポイントを使用して、トピック内のすべてのメンションを取得します。このAPIサポートページでは、あなたのメンションについてどのような情報が取得されるかについて説明します。

また、Social Connectオートメーションレシピ機能を使用して、アプリケーションのウェブフックを呼び出すワークフローを設計することもできます。

APIから返されるツイートに詳細がないのはなぜですか？

ツイートについては、クアルトリクスはソーシャルコネクト固有のデータとTwitterのツイートIDのみを返すことができます。これはTwitter API規約による制限です。

ツイートIDを持っているので、Twitter APIにアクセスし、すべての詳細を取得するために“/statuses/lookup “エンドポイントを使用することができます。

なぜフェイスブックの投稿は匿名なのか？

Facebookの公開投稿（Facebookページ上のメッセージではなく、キーワード検索によってソーシャルコネクトによってピックアップされます）は匿名化されます。これはFacebook APIの制限です。

ソーシャル・コネクトに独自のメッセージを追加できますか？

連絡先フォームや社内フォーラムをSocial Connectで監視したい場合は、「/{account_id}/inbox/add」エンドポイントを呼び出して、カスタムメッセージをSocial Connectに追加できます。これらのメッセージは、受信トレイとインサイトでアクセシビリティが得られます。

API経由でSocial Connectに追加されたメッセージは、Social Connectから返信することはできません。 カスタムシステムとの緊密な統合をご希望の場合は、サポートまでお問い合わせください。

API 経由で症例をエクスポートできますか?

ケースをエクスポートするには、通常の言及エンドポイント (リストのエクスポート / 単一の言及の更新) を使用できます。リクエストの中でケースだけを返したい場合は、’sub_category:case’フィルタを使うことができます。

apiのケースとメンションの違いは何ですか？

Social Connectでは、”言及 “はメッセージの中心的なオブジェクトである（1つのツイート、1つのプライベートメッセージ、1つのコメント）。ケース」という概念もある。

ケースの主な用途は、特定のユーザーからの複数のメッセージとエージェントからの返信を会話にグループ化することです。

技術的な観点からの “ケースの会話 “は次のようなものである：

• ケースそのもの（これも言及対象である）。
• ケースはラベル、ステータス、タイトルなどを持つことができる。
• 会話の一部である言及のリスト。
• ケースにグループ化された言及。

ケースとメンションについての詳細は、このAPIサポートページを参照してください。

Social Connectの送信トレイにメッセージをインポートできますか？

エンドポイント”/{account_id}/publisher/add “を通じて、ソーシャルマネージャーが確認、編集、公開するための新しい投稿の下書きを作成することができます。

API経由で言及を編集できますか？

既存のメンションを編集するには、”/{account_id}/inbox/mention/{topic_id}/{id}”エンドポイントを使用します。このエンドポイントのドキュメントには、言及のタグの更新やノートの追加などの例があります。

api経由でENGAGEの特定のユーザーのデータをすべて削除するにはどうすればよいですか？

Social Connectアカウントにある特定の顧客のデータをすべて削除する場合は、2種類のデータを削除する必要があります：

1. システム内のそのユーザーからのすべての言及
2. ソーシャルコネクトCRMに保存されているユーザーに関するすべての情報。

特定のユーザーからのすべてのメンションを見つけるには、”/{account_id}/inbox/mentions “エンドポイントを使用し、”author.id:123 “などの特定のauthorIDでフィルタします。メンションのリストができたら、”/{account_id}/inbox/mention/{topic_id}/{id}”エンドポイントを使用してメンションを削除することができます。

エージェントがSocial Connect CRMに連絡先データを保存したかどうかを知るには、”/{account_id}/inbox/contact/{service}/{service_id}”にGETリクエストしてください。レスポンスオブジェクトに contact.id が含まれる場合、このユーザーの連絡先が存在することを意味します。回答にcontact.idプロパティが含まれていない場合は、Social Connect CRMにデータが保存されていないことを意味します。

連絡先.idを取得したら、/{account_id}/inbox/contact/{contact_id}エンドポイントにDELETEリクエストを行い、すべての情報を削除することができます。

連絡先での作業

言及や事例から連絡先を見つけるにはどうすればよいですか？

apiによって言及またはケースが返される場合、それは“action_link “オブジェクトのリストを含む。アクションリンクには、現在のオブジェクトに対して、このオブジェクトに関連する他のAPIエンドポイントやWebアプリケーション内のUrlに関する情報が含まれています。言及や事例については、含まれるアクションリンクの1つで、言及や事例の作成者の連絡先を取得することができます。

account_id}/inbox/casesエンドポイントを使用する場合、デフォルトで言及の作成者の連絡先オブジェクトが含まれます。クアルトリクスは、メンション用の完全な連絡先オブジェクトを含んでいませんが、アクションリンクを介して、このオブジェクトは、別のAPIコールを行うことによって取得することができます。

公開

ソーシャルチャンネルへの公開にクラブリッジENGAGE APIを使用できますか？

いいえ、APIではサードパーティのプラットフォームに直接公開することはできません。つまり、Social Connect APIを使用してツイートやFacebookのコメントを公開することはできません。

しかし、Social Connect APIを使用して、下書きを作成したり、承認のためにメッセージをキューに入れたりすることができます。これらは、承認され次第公開されるか、ソーシャル・コネクトのインターフェースを通じて公開される。ドラフト・メッセージのエンドポイントは /{account_id}/publisher/add です。

ユーザーマネージャー

API経由でユーザーのステータスを変更できますか？

いいえ、API経由でユーザーのステータスを変更することはできません。ステータスを変更することはできませんが、/{account_id}/settings/user/{id}エンドポイントを介して、名前、会社、Eメール、アバター、営業時間スケジュールを変更することができます。

API経由でユーザーのUser Roleを変更できますか？

api経由でユーザーのロールを変更することが可能です。しかし、セキュリティ上の理由から、ユーザー・ロールを管理者に変更することはできません。他のすべてのユーザ・ロールは、/{account_id}/settings/user/{id}エンドポイント経由で変更可能です。

API 経由で新しいユーザを作成できますか？

セキュリティ上の理由により、API経由ではできません。

ソーシャル・プロファイリングを使う

トピック内のソーシャル・プロフィールの情報を取得できますか？

account_id}/inbox/contact/{service}/{service_id}”エンドポイントを経由して、特定のソーシャル・プロファイルに関する情報をフェッチできます。これには、性別、Eメール、ユーザー属性など、Social Connect CRMで入力した情報が含まれます。

インサイトとの取り組み

クララブリッジENGAGEから統計を取ることはできますか？

インサイトからデータを引き出すには、2種類のAPIエンドポイントを使用します；

1. /{account_id}/dashboards/export/{dashboard_id}” エンドポイントは、特定のダッシュボード上のすべてのウィジェットのデータを返します。あなたやあなたのユーザーがカスタム・ダッシュボードを設定したら、このエンドポイントを使用して、その背後にあるデータを取得することができます。
2. “/{account_id}/insights/facets “エンドポイントは、Social Connectのチャートビルダー機能に相当するapiとして機能します。

問題点

アカウントIDはどこで確認できますか？

自分らしくいられること “を認証したら、”/me/accounts “エンドポイントを通して、そのユーザーがアクセシビリティを持っているすべてのアカウント（とそのID）のリストを取得することができます。

自分のトピックIDはどこにありますか？

自分らしくいられること “を認証すると、”/me/accounts “エンドポイントから、そのユーザーがアクセシビリティを持つすべてのトピック（とそのID）のリストを取得できます。

自分のユーザーIDはどこにありますか？

認証機能を使用すると、”/me “エンドポイントから認証ユーザーの詳細（自分らしくいられること）を取得することができます。