> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks FAQs

> 管理、ネットワークサポート、リトライ、トラブルシューティングを含むWebhooksに関する最も一般的な質問への回答を取得

## クレジットとレート制限

<Accordion title="1つのWebhookにいくつのアドレスを入力できますか？">
  [API](/ja/api-reference/webhooks/create-webhook)を使用して最大100,000のアドレスを入力できます。
</Accordion>

<Accordion title="Webhookを作成した後にHeliusダッシュボードでWebhook URLを変更するとクレジットがかかりますか？">
  はい、APIまたはダッシュボードを介してWebhookを編集することは、リクエストごとに100クレジットのコストがかかります。これは、URLの変更、アドレスの追加/削除、またはトランザクションタイプの更新など、すべての修正に適用されます。
</Accordion>

<Accordion title="Webhook通知を受け取るのにいくらのクレジットがかかりますか？">
  Heliusがイベントを処理してエンドポイントに送信するたびに、各Webhookイベントは1クレジットかかります。エンドポイントがWebhookを正常に処理したかエラーを返したかに関係なく、料金がかかります。
</Accordion>

<Accordion title="Webhookを作成、編集、削除するのにいくらのコストがかかりますか？">
  APIを介して行われるWebhook管理操作（作成、編集、削除）は、リクエストごとに100クレジットのコストがかかります。これはWebhook設定を更新するために必要な処理をカバーします。
</Accordion>

## サポートされているネットワーク

<Accordion title="Solana DevnetでWebhookは利用できますか？">
  はい。UIを通じてWebhookを作成する場合、「devnet」を「Network」として選択します。Webhook APIを介して作成する場合、「webhookType」パラメータを「rawDevnet」「enhancedDevnet」または「discordDevnet」に設定します。
</Accordion>

<Accordion title="Webhook URLに'localhost'を入力できますか？">
  いいえ—URLはHTTPSを介して公開アクセス可能でなければなりません。Heliusはlocalhost URLを介してローカル開発サーバーにアクセスできません。
</Accordion>

## Webhooksの使用

<Accordion title="WebhookがHeliusからのものであることを確認するにはどうすればよいですか？">
  Webhookを作成または更新する際に、認証ヘッダーを設定します。Heliusはこの値をデータをWebhookエンドポイントに送信する際に`Authorization`ヘッダーでエコーし、リクエストの真正性を確認できます。
</Accordion>

<Accordion title="'raw'と'enhanced'のWebhookの違いは何ですか？">
  **Raw Webhooks**はブロックチェーンから直接Solanaトランザクションデータを返します。モニタリング対象のアドレスでトランザクションが発生すると、生のトランザクションデータがWebhook URLに送信されます。

  **Enhanced Webhooks**はHeliusの解釈したトランザクションタイプを提供します。100種類以上のSolanaトランザクション（NFTリスティング、DeFiスワップ、転送など）を解析し、独自のスキーマに抽象化します。

  生のWebhooksを使用すると、抽象化なしで全てのトランザクションデータが取得され、内蔵のトランザクションタイプ検出と解析が欲しい場合はEnhanced Webhooksを使用します。
</Accordion>

<Accordion title="Webhookはいつ通知を送信しますか？">
  Webhookは、ブロックチェーン上で一致するトランザクションが確認された直後に通知を送信します。
</Accordion>

## リトライ

<Accordion title="エンドポイントはWebhookイベントをどのように確認すべきですか？">
  エンドポイントは、**1秒以内**に`200`ステータスコードを返して正常な受信を確認する必要があります。ベストプラクティスとして、即座に`200`で応答し、処理は非同期で行います — これは遅いビジネスロジックによるタイムアウトを防ぎます。
</Accordion>

<Accordion title="Webhookのリトライポリシーは何ですか？">
  Heliusは、エンドポイントが`5xx`エラー、`4xx`エラー（`403`を除く）、タイムアウト、または接続エラーやDNS障害により失敗した場合に配信をリトライします。最大**3回**まで1秒間隔でリトライします。

  すべてのリトライが失敗した場合、イベントは**永久に失われ**ます — 再キューや二次配信サイクルはありません。

  [Helius Dashboard](https://dashboard.helius.dev/webhooks)でWebhookログを監視し、配信失敗を特定し、エンドポイントの問題を調査します。

  エンタープライズプランでは、カスタマイズ可能なリトライポリシーも提供しています。
</Accordion>

<Accordion title="Webhookイベントは一度だけ配信されますか？">
  Heliusは同じWebhookイベントを複数回配信することがあります。これはリトライロジックやネットワークの問題によるものです。

  Webhookハンドラは重複を管理する必要があります — 同じイベントを複数回処理しても、1回だけ処理する場合と同じ結果を生成するべきです。

  重複を管理するために、トランザクション署名またはユニークなイベント識別子を使用して、すでに処理したイベントを追跡します。
</Accordion>

<Accordion title="Webhookは失敗したトランザクションを投稿しますか？">
  Webhookのタイプによります。Enhanced Webhooksは失敗したトランザクションを送信しませんが、Raw Webhooksは成功したトランザクションと失敗したトランザクションの両方を含みます。
</Accordion>

## 自動無効化

<Accordion title="なぜWebhookが自動的に無効になったのですか？">
  Heliusはエンドポイントの健全性を監視し、配信失敗率\*\*≥ 95%\*\*のWebhookを自動的に無効にします。有料プラン（Dev以上）は7日間のウィンドウで評価され、フリープランのWebhookは24時間のウィンドウで評価されます。これは到達不能なエンドポイントへの無駄な配信試行を防ぎます。

  一般的な原因には、到達不能なエンドポイントURL、サーバーが一貫してエラー応答を返すこと、またはネットワーク/ファイアウォールの問題でHeliusの配信がブロックされることが含まれます。
</Accordion>

<Accordion title="無効になったWebhookを再度有効にするにはどうすればよいですか？">
  1. エンドポイントの根本的な問題を修正します。
  2. [Helius Dashboard](https://dashboard.helius.dev/webhooks)にログインします。
  3. 無効になったWebhookを見つけて再度オンに切り替えます。

  [Toggle Webhook APIエンドポイント](/ja/api-reference/webhooks/toggle-webhook)を介してPATCHリクエストを送信し、プログラムでWebhookを再有効化することもできます。
</Accordion>

<Accordion title="再度有効にした直後にWebhookがまた無効になりますか？">
  いいえ。再度有効にした後、Webhookは**24時間の猶予期間**に入り、その間は自動的に無効になりません。これは次回の評価前にエンドポイントが正常であることを確認する時間を提供します。
</Accordion>

<Accordion title="Webhookが自動的に無効になった際に通知されますか？">
  はい — **Devプラン以上**のユーザーには、Webhookが自動的に無効になった際にメール通知が送られます。フリープランのユーザーは[Helius Dashboard](https://dashboard.helius.dev/webhooks)でWebhookのステータスを監視できます。
</Accordion>

<Accordion title="Webhookを削除せずに無効にすることはできますか？">
  はい。[Helius Dashboard](https://dashboard.helius.dev/webhooks)または[Toggle Webhook APIエンドポイント](/ja/api-reference/webhooks/toggle-webhook)経由でWebhooksをオン・オフ切り替えることができます。これはWebhook設定を保持したまま配信を一時停止することを可能にします。
</Accordion>

## Webhooksのトラブルシューティング

<Accordion title="なぜWebhookがデータをドロップするのですか？">
  データのドロップは通常、エンドポイントがエラーに遭遇し、Webhook再試行が最終的に失敗し、データ損失につながる時に発生します。[ダッシュボード](https://dashboard.helius.dev/webhooks)でWebhookログを確認し、十分なクライアントサイドログを実装し、問題が解決しない場合はサポートに[連絡](/ja/support/contact-support)してください。
</Accordion>

<Accordion title="なぜWebhookがうまく動作しないのですか？">
  選択したトランザクションタイプが監視しているトランザクションと一致しているか確認してください。「ANY」トランザクションタイプから始めて、一般的な問題かタイプの不一致かを特定します。[webhook.site](http://webhook.site/)を使用して、問題がエンドポイント設定にあるかどうかをテストしてください。
</Accordion>

<Accordion title="ある特定のタイプ（例えばTOKEN_MINT）の全トランザクションが送信されないのはなぜですか？">
  `TOKEN_MINT` WebhookはCandy Machine V1やSolana Program Libraryのような特定のプログラムでのみトリガーされます。ブロックチェーン全体の全てのトークンミントイベントをカバーしているわけではありません。より広範囲な監視を行うには、「ANY」トランザクションタイプフィルタリングを使用したWebhookによるより一般的なアカウントまたはプログラムサブスクリプションを検討してください。
</Accordion>

***

## さらに助けが必要ですか？

<CardGroup cols={2}>
  <Card title="サポートに連絡" icon="headset" href="/ja/support/contact-support">
    Discord、チャット、またはメールサポートを通じて当社のチームから助けを得ることができます。
  </Card>

  <Card title="ステータスページ" icon="wave-pulse" href="/ja/support/status-page">
    リアルタイムのサービス可用性とパフォーマンス情報を確認できます。
  </Card>
</CardGroup>