他のシステムにイベントを送信する方法

Where: 設定 → 高度な設定 → 他のアプリと連携

このページを開く: admin.<your-site>/settings/integrations/webhooks (<your-site> をご自身のサイトアドレスに置き換えてください)。メニューに表示されない場合は、設定ページで Show all settings を有効にしてください。

事前準備

• Webhookを追加できるのはサイトの所有者のみです。
• 受信先アドレスは https:// で始まり、一般のインターネットからアクセスできる必要があります。

手順

1. Settings → Advanced → Connect other apps → Webhooks を開きます。
2. Add webhook を押します。
3. Name (例: Zapier) と Address that receives the messages を入力します。
4. Send me a message when で対象イベントにチェックを入れます: A story goes live、A live story is changed、A story is taken down、A correction is added、A story is retracted、A new comment、A subscription changes。
5. Add webhook を押します。
6. 署名シークレットをコピーします。一度しか表示されません。I saved it を押します。
7. Send test event を試します。

補足情報

• すべてのメッセージは署名されています。ご自身のサイトから届いたものであることを確認するには、「Keynate-Signature」ヘッダーをご確認ください。
• 受信側のシステムは、正常に受信できたことを伝えるために任意の2xxステータスを返します。
• 送信に失敗したメッセージは最大24時間再試行されます。3日間失敗が続いたWebhookは停止されます。受信側の問題を解消してから、Resume を押してください。
• Pause、Resume、または New secret を行えます。古いシークレットは、指定した一定期間引き続き有効です。
• 一覧には各Webhookの状態が表示されます: Working、Not used yet、Not working、Paused、Switched off。
• 送信済みメッセージを開いて再試行履歴を確認し、Send again を押します。

トラブルシューティング

• 「アドレスは https://." で始まる必要があります」
• 「Webhookの名前を入力してください。」
• 「イベントを少なくとも1つ選択してください。」
• 「作成できるWebhookの上限に達しました。不要なものを削除してから再度お試しください。」

よくある質問

関連記事

• 他のアプリとの連携
• APIキー