> ## 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.

# FAQ sur les Webhooks

> Obtenez des réponses aux questions les plus courantes sur les webhooks, y compris la gestion, la prise en charge réseau, les nouvelles tentatives et le dépannage.

## Crédits et Limites de Taux

<Accordion title="Combien d'adresses puis-je saisir pour 1 webhook ?">
  Jusqu'à 100 000 adresses en utilisant l'[API](/docs/fr/api-reference/webhooks/create-webhook).
</Accordion>

<Accordion title="Serai-je facturé en crédits si je change l'URL du webhook dans le tableau de bord Helius après la création du webhook ?">
  Oui, modifier un webhook via l'API ou le tableau de bord coûte 100 crédits par requête. Cela s'applique à toute modification, y compris les changements d'URL, l'ajout/suppression d'adresses ou la mise à jour des types de transactions.
</Accordion>

<Accordion title="Combien de crédits coûte la réception d'une notification de webhook ?">
  Chaque événement de webhook coûte 1 crédit lorsque Helius traite et envoie l'événement à votre point de terminaison. Vous êtes facturé que votre point de terminaison traite avec succès le webhook ou renvoie une erreur.
</Accordion>

<Accordion title="Combien cela coûte-t-il de créer, modifier et supprimer des webhooks ?">
  Toutes les opérations de gestion des webhooks (création, modification, suppression) coûtent 100 crédits par requête lorsqu'elles sont effectuées via l'API. Cela couvre le traitement requis pour mettre à jour vos configurations de webhook.
</Accordion>

## Réseaux Pris en Charge

<Accordion title="Les webhooks sont-ils disponibles sur Solana Devnet ?">
  Oui. Si vous créez un webhook via l'interface utilisateur, choisissez "devnet" comme "Réseau". Si vous le créez via l'API Webhook, définissez le paramètre "webhookType" sur "rawDevnet", "enhancedDevnet" ou "discordDevnet" selon le type de webhook souhaité.
</Accordion>

<Accordion title="Puis-je entrer 'localhost' pour l'URL de mon webhook ?">
  Non — l'URL doit être accessible publiquement via HTTPS. Helius ne peut pas accéder aux serveurs de développement local via les URL localhost.
</Accordion>

## Utilisation des Webhooks

<Accordion title="Comment puis-je vérifier que le webhook provient de Helius ?">
  Définissez un en-tête d'autorisation lors de la création ou de la mise à jour du webhook. Helius répercute cette valeur dans l'en-tête `Authorization` lors de l'envoi de données à votre point de terminaison webhook, vous permettant de vérifier l'authenticité de la requête.
</Accordion>

<Accordion title="Quelle est la différence entre les webhooks 'bruts' et 'améliorés' ?">
  **Les webhooks bruts** renvoient des données de transaction Solana régulières directement de la blockchain. Lorsqu'une transaction se produit pour les adresses surveillées, les données de transaction brutes sont envoyées à votre URL de webhook.

  **Les webhooks améliorés** fournissent les types de transactions interprétés par Helius. Nous analysons plus de 100 types de transactions Solana (listes NFT, échanges DeFi, transferts, etc.) et les abstraisons dans notre propre schéma.

  Utilisez les webhooks bruts si vous souhaitez toutes les données de transaction sans abstraction, ou les webhooks améliorés si vous souhaitez une détection et une analyse des types de transactions intégrées.
</Accordion>

<Accordion title="Quand le webhook envoie-t-il une notification ?">
  Les webhooks envoient des notifications immédiatement après qu'une transaction correspondante est confirmée sur la blockchain.
</Accordion>

## Nouvelles Tentatives

<Accordion title="Comment mon point de terminaison doit-il reconnaître un événement de webhook ?">
  Votre point de terminaison doit renvoyer un code de statut `200` dans un **délai de 1 seconde** pour reconnaître la réception réussie. Comme bonne pratique, répondez avec `200` immédiatement et traitez toute opération de manière asynchrone — cela évite les délais d'attente causés par une logique métier lente.
</Accordion>

<Accordion title="Quelle est la politique de nouvelle tentative pour les webhooks ?">
  Helius retente la livraison lorsque votre point de terminaison renvoie une erreur `5xx`, une erreur `4xx` (sauf `403`), expire, ou échoue en raison d'une erreur de connexion ou d'une défaillance DNS. Nous tentons jusqu'à **3 fois** avec un **intervalle de 1 seconde** entre chaque tentative.

  Si toutes les tentatives de nouvelle tentative échouent, l'événement est **perdu définitivement** — il n'y a pas de nouvelle mise en file d'attente ou de second cycle de livraison.

  Surveillez vos journaux de webhook dans le [Tableau de bord Helius](https://dashboard.helius.dev/webhooks) pour identifier les échecs de livraison et enquêter sur les problèmes de point de terminaison.

  Nous proposons également des politiques de nouvelle tentative personnalisables pour les forfaits entreprises.
</Accordion>

<Accordion title="Un événement de webhook est-il livré exactement une fois ?">
  Helius peut livrer plusieurs fois le même événement de webhook. Cela peut se produire en raison de la logique de nouvelle tentative ou des problèmes réseau.

  Votre gestionnaire de webhook doit être prêt à gérer les doublons de manière élégante — traiter le même événement plusieurs fois doit produire le même résultat que le traiter une fois.

  Pour gérer les duplications, utilisez la signature de transaction ou un identifiant d'événement unique pour suivre les événements que vous avez déjà traités.
</Accordion>

<Accordion title="Les webhooks postent-ils des transactions échouées ?">
  Cela dépend du type de webhook. Les webhooks améliorés n'envoient pas de transactions échouées, mais les webhooks bruts incluent les transactions réussies et échouées.
</Accordion>

## Désactivation Automatique

<Accordion title="Pourquoi mon webhook a-t-il été désactivé automatiquement ?">
  Helius surveille la santé du point de terminaison et désactive automatiquement les webhooks ayant un **taux d'échec de livraison ≥ 95 %**. Les forfaits payants (Dev et supérieur) sont évalués sur une période de 7 jours, tandis que les webhooks du forfait gratuit sont évalués sur une période de 24 heures. Cela permet d'éviter les tentatives de livraison inutiles vers des points de terminaison inaccessibles.

  Les causes courantes incluent une URL de point de terminaison injoignable, votre serveur renvoyant des réponses d'erreur cohérentes ou des problèmes de réseau/pare-feu bloquant les livraisons Helius.
</Accordion>

<Accordion title="Comment puis-je réactiver un webhook désactivé ?">
  1. Corrigez le problème sous-jacent avec votre point de terminaison.
  2. Connectez-vous au [Tableau de bord Helius](https://dashboard.helius.dev/webhooks).
  3. Trouvez le webhook désactivé et réactivez-le.

  Vous pouvez également réactiver les webhooks par programmation via le [Point de terminaison de l'API Toggle Webhook](/docs/fr/api-reference/webhooks/toggle-webhook) en envoyant une requête PATCH avec `{ "active": true }`.
</Accordion>

<Accordion title="Mon webhook sera-t-il désactivé à nouveau juste après l'avoir réactivé ?">
  Non. Après réactivation, le webhook entre dans une **période de grâce de 24 heures** pendant laquelle il ne sera pas désactivé automatiquement. Cela vous permet de vérifier que votre point de terminaison est sain avant la prochaine évaluation.
</Accordion>

<Accordion title="Serai-je notifié lorsqu'un webhook est désactivé automatiquement ?">
  Oui — les utilisateurs sur le **forfait Dev et supérieur** reçoivent une notification par e-mail lorsqu'un webhook est désactivé automatiquement. Les utilisateurs du forfait gratuit peuvent surveiller le statut des webhooks dans le [Tableau de bord Helius](https://dashboard.helius.dev/webhooks).
</Accordion>

<Accordion title="Puis-je désactiver un webhook sans le supprimer ?">
  Oui. Vous pouvez activer et désactiver les webhooks depuis le [Tableau de bord Helius](https://dashboard.helius.dev/webhooks) ou via le [Point de terminaison de l'API Toggle Webhook](/docs/fr/api-reference/webhooks/toggle-webhook). Cela vous permet de suspendre temporairement les livraisons sans perdre votre configuration de webhook.
</Accordion>

## Dépannage des Webhooks

<Accordion title="Pourquoi mon webhook perd-il des données ?">
  La perte de données se produit généralement lorsque votre point de terminaison rencontre une erreur, provoquant des tentatives de webhook qui échouent finalement et entraînent une perte de données. Vérifiez vos journaux de webhook dans le [tableau de bord](https://dashboard.helius.dev/webhooks), assurez-vous qu'une journalisation côté client suffisante est en place, et [contactez le support](/docs/fr/support/contact-support) si le problème persiste.
</Accordion>

<Accordion title="Pourquoi mes webhooks ne fonctionnent-ils pas ?">
  Assurez-vous que le type de transaction sélectionné correspond aux transactions que vous surveillez. Commencez par le type de transaction "ANY" pour identifier s'il s'agit d'un problème général ou d'une incompatibilité de type. Utilisez [webhook.site](http://webhook.site/) pour tester si le problème provient de la configuration de votre point de terminaison.
</Accordion>

<Accordion title="Pourquoi mon webhook ne m'envoie-t-il pas toutes les transactions d'un certain type (comme TOKEN_MINT) ?">
  Le webhook `TOKEN_MINT` ne se déclenche que pour certains programmes comme Candy Machine V1 et Solana Program Library. Il ne couvre pas tous les événements de minting de tokens à travers toute la blockchain. Pour une surveillance plus large, envisagez d'utiliser un abonnement de compte ou de programme plus général via des webhooks avec un filtrage de type de transaction "ANY".
</Accordion>

***

## Besoin de Plus d'Aide ?

<CardGroup cols={2}>
  <Card title="Contacter le Support" icon="headset" href="/docs/fr/support/contact-support">
    Obtenez de l'aide de notre équipe via Discord, chat ou support par e-mail.
  </Card>

  <Card title="Page de Statut" icon="wave-pulse" href="/docs/fr/support/status-page">
    Vérifiez la disponibilité et les informations de performance des services en temps réel.
  </Card>
</CardGroup>