ヘルプセンター統合

のために: 管理者

フィードアクティビティ用のウェブフックを設定する

フィードの投稿、コメント、添付ファイルが追加、変更、削除されるたびに、独自のシステムにメッセージを送信します。

この記事では8 セクション

A ウェブハックWebhook フィードの投稿やコメントが変更されるたびに、ハブがあなたのシステムにメッセージを送信できるように、ハブに指定するアドレスです。 選択した事象が、そのケースで発生するたびに、自動的にその情報をシステムに送信します。 フィードフィード 訴訟に関する投稿のタイムライン。法律事務所がニュースを共有し、訴訟に関わる全員がコメントできる場所。, 新しい投稿やコメントなどです。各メッセージは暗号化されているため、それを受け取るシステムには、そのメッセージを読み取るための開発者のコードが必要です。

  1. オープンウェブフック

    統合 › Webhookに移動し、新しいを選択してください。

  2. 住所を入力してください

    URLの下に、メッセージを受信するシステムのアドレスを入力してください。例えば、https://crm.example.com/hooks/caseactiveなどです。このアドレスは、https://またはhttp://で始まっている必要があります。また、インターネットからアクセス可能な場所であることも必要です。大文字の文字も、そのまま入力されます。

    説明はオプションです。これは、チーム向けのメモとして機能します。例えば、CRMシステムに案件情報を記録するようなものです。

  3. イベントを選択してください

    イベントの下には、メッセージを送信すべきものが記載されています。例えば、投稿が作成されましたや投稿コメントが作成されましたなどです。これらは、投稿内容、投稿へのコメント、またはファイルの追加や削除に関する情報を含んでいます。Webhookイベントとペイロードについては、こちらを参照してください。というように、各項目が何を送信するかが説明されています。

  4. スイッチを入れて保存する

    アクティブは、無効な状態で待機しています。この状態にしておくと、ウェブホックから何も受信されず、受信できなかったデータは後で送信されません。保存を選択してください。「ウェブホックが追加されました」というメッセージが表示されます。

  5. 秘密を守る

    シークレットウェブフックウィンドウには、ウェブホックのシークレットが表示されます。これは、送信される各メッセージを開くための秘密鍵です。この情報は一度だけ表示されます。.pemファイルとしてダウンロードを選択すると、その情報をファイルとして保存できます。また、クリップボードにコピーを選択すると、行切れを含む全体の情報をコピーできます。この情報を、パスワードマネージャーなどを通じて、開発者に安全に渡してください。その後、できたを選択します。

  6. 試してみる

    実際にクライアントがいないケースについて、短い投稿を追加しましょう。例えば、あなたのハブが最初に作成した2つのサンプルケースのうちの1つです。開発者は、メッセージが届いたかどうか、そしてそのメッセージが正しく読み取られているかを確認します。

次に何が起こるのか

Hub内の任意のケースで、選択されたイベントが発生するたびに、ウェブハックを通じて、その変更を行った人に関するメッセージがシステムに送信されます。その人は、あなたのチームのメンバーであったり、クライアントであったり、バーチャルアシスタントバーチャルアシスタント 会社への歓迎メッセージ、チェックイン、ステージングに関する投稿を行う自動化されたチームメンバー。その投稿にはバーチャルアシスタントのバッジが付いています。、あるいはAPIキーを使った人かもしれません。他の人には何も通知されません。

もし、連続して2回の配布が失敗した場合、ウェブハックは停止し、各管理者にはメールが送信されます。詳細はこちらをご覧ください。 送信が停止しているウェブホックを修正してください。. 住所やイベントを変更するには、鉛筆アイコンを選んでください。 ウェブフックを編集, その行には、秘密が残っている。

何か問題が発生した場合

  • ウェブホックの制限に達しました。 ホームには、最大5つのウェブハックを設定できます。使用しなくなったウェブハックは削除してください。そのためには、バッケージアイコンを選択します。 ウェブフックを削除する, その行に、そうして。 消去. すぐに停止してしまい、もう復帰することはできません。
  • そのURLは「URLが有効ではありません。例:https://example.com/hook」と表示されています。 https:// や http:// から始まる完全なURLを入力してください。自分のコンピューター上でのみ動作するURLは受け付けられません。
  • あなたはその秘密を失ってしまいました。 もう、その秘密を表示することはできません。同じアドレスとイベントを持つ新しいウェブホックを追加し、その秘密を開発者に渡してください。そして、古いウェブホックを削除してください。

関連記事

ウェブフックイベントとペイロードを調べてください10個のフィードイベントそれぞれが何を送信するのか、メッセージがどのように暗号化されるのか、そして秘密鍵を使ってそれを復号化する方法について説明します。統合送信が停止していたウェブフックを修正するウェブフックが2回の配信失敗後、または非アクティブ状態になった後に停止する理由、そして再度保存することでウェブフックが再び有効になる仕組みについて説明します。統合APIで何ができるかを理解しましょう管理キーとハブキーがそれぞれどのような範囲にアクセスできるのか、なぜすべてのキーが仮想アシスタントとして機能するのか、そして完全な技術仕様書はどこにあるのかを学びましょう。統合