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

# Preguntas frecuentes sobre webhooks

> Obtén respuestas a las preguntas más comunes sobre webhooks, como su administración, compatibilidad con redes, reintentos y solución de problemas

## Créditos y límites de frecuencia

<Accordion title="How many addresses can I input for 1 webhook?">
  Hasta 100,000 direcciones mediante la [API](/docs/es/api-reference/webhooks/create-webhook).
</Accordion>

<Accordion title="Will I be charged credits if I change the webhook URL in the Helius dashboard after creating the webhook?">
  Sí, editar un webhook mediante la API o el panel cuesta 100 créditos por solicitud. Esto se aplica a cualquier modificación, incluidos los cambios de URL, agregar o eliminar direcciones y actualizar los tipos de transacción.
</Accordion>

<Accordion title="How many credits does it cost to receive a webhook notification?">
  Cada evento de webhook cuesta 1 crédito cuando Helius procesa y envía el evento a tu endpoint. Se te cobra independientemente de si tu endpoint procesa correctamente el webhook o devuelve un error.
</Accordion>

<Accordion title="How much does it cost to create, edit, and delete webhooks?">
  Todas las operaciones de administración de webhooks (crear, editar y eliminar) cuestan 100 créditos por solicitud cuando se realizan mediante la API. Esto cubre el procesamiento necesario para actualizar las configuraciones de tus webhooks.
</Accordion>

## Redes compatibles

<Accordion title="Are webhooks available on Solana Devnet?">
  Sí. Si creas un webhook mediante la interfaz de usuario, elige “devnet” como “Network”. Si lo creas mediante la API de Webhook, configura el parámetro “webhookType” como "rawDevnet", "enhancedDevnet" o “discordDevnet”, según el tipo de webhook que quieras.
</Accordion>

<Accordion title="Can I input 'localhost' for my webhook URL?">
  No; la URL debe ser accesible públicamente mediante HTTPS. Helius no puede acceder a servidores de desarrollo locales mediante URL de localhost.
</Accordion>

## Uso de webhooks

<Accordion title="How can I verify that the webhook came from Helius?">
  Configura un encabezado de autorización al crear o actualizar el webhook. Helius replica este valor en el encabezado `Authorization` cuando envía datos al endpoint de tu webhook, lo que te permite verificar la autenticidad de la solicitud.
</Accordion>

<Accordion title="What is the difference between 'raw' and 'enhanced' webhooks?">
  Los **webhooks sin procesar** devuelven datos normales de transacciones de Solana directamente desde la blockchain. Cuando ocurre una transacción para las direcciones monitoreadas, los datos sin procesar de la transacción se envían a la URL de tu webhook.

  Los **webhooks mejorados** proporcionan los tipos de transacción interpretados por Helius. Analizamos más de 100 tipos de transacciones de Solana (publicaciones de NFT, intercambios DeFi, transferencias, etc.) y los abstraemos en nuestro propio esquema.

  Usa webhooks sin procesar si quieres todos los datos de las transacciones sin abstracciones, o webhooks mejorados si quieres detección y análisis integrados de los tipos de transacción.
</Accordion>

<Accordion title="When does the Webhook send a notification?">
  Los webhooks envían notificaciones inmediatamente después de que se confirma una transacción coincidente en la blockchain.
</Accordion>

## Reintentos

<Accordion title="How should my endpoint acknowledge a webhook event?">
  Tu endpoint debe devolver un código de estado `200` en un plazo de **1 segundo** para confirmar que recibió el evento correctamente. Como práctica recomendada, responde de inmediato con `200` y realiza cualquier procesamiento de forma asíncrona. Esto evita tiempos de espera agotados causados por una lógica de negocio lenta.
</Accordion>

<Accordion title="What is the retry policy for webhooks?">
  Helius reintenta la entrega cuando tu endpoint devuelve un error `5xx`, un error `4xx` (excepto `403`), agota el tiempo de espera o falla debido a un error de conexión o de DNS. Realizamos hasta **3 reintentos** con un **intervalo de 1 segundo** entre cada intento.

  Si todos los reintentos fallan, el evento se **pierde permanentemente**; no se vuelve a poner en cola ni existe un segundo ciclo de entrega.

  Monitorea los registros de tu webhook en el [panel de Helius](https://dashboard.helius.dev/webhooks) para identificar fallas de entrega e investigar problemas con el endpoint.

  También ofrecemos políticas de reintento personalizables para los planes empresariales.
</Accordion>

<Accordion title="Is a webhook event delivered exactly once?">
  Helius puede entregar el mismo evento de webhook varias veces. Esto puede ocurrir debido a la lógica de reintentos o a problemas de red.

  El controlador de tu webhook debe estar preparado para gestionar correctamente los duplicados: procesar el mismo evento varias veces debe producir el mismo resultado que procesarlo una sola vez.

  Para gestionar los duplicados, usa la firma de la transacción o un identificador único del evento para llevar un registro de los eventos que ya procesaste.
</Accordion>

<Accordion title="Do webhooks post failed transactions?">
  Depende del tipo de webhook. Los webhooks mejorados no envían transacciones fallidas, pero los webhooks sin procesar incluyen tanto las transacciones correctas como las fallidas.
</Accordion>

## Desactivación automática

<Accordion title="Why was my webhook automatically disabled?">
  Helius monitorea el estado de los endpoints y desactiva automáticamente los webhooks con una **tasa de fallas de entrega ≥ 95 %**. Los planes de pago (Dev y superiores) se evalúan durante un periodo de 7 días, mientras que los webhooks del plan Free se evalúan durante un periodo de 24 horas. Esto evita desperdiciar intentos de entrega en endpoints inaccesibles.

  Entre las causas comunes se incluyen una URL de endpoint inaccesible, respuestas de error constantes de tu servidor o problemas de red o firewall que bloquean las entregas de Helius.
</Accordion>

<Accordion title="How do I re-enable a disabled webhook?">
  1. Corrige el problema subyacente de tu endpoint.
  2. Inicia sesión en el [panel de Helius](https://dashboard.helius.dev/webhooks).
  3. Busca el webhook desactivado y vuelve a activarlo.

  También puedes volver a activar webhooks mediante programación a través del [endpoint de la API para activar o desactivar webhooks](/docs/es/api-reference/webhooks/toggle-webhook). Para ello, envía una solicitud PATCH con `{ "active": true }`.
</Accordion>

<Accordion title="Will my webhook get disabled again right after I re-enable it?">
  No. Después de volver a activarlo, el webhook entra en un **periodo de gracia de 24 horas** durante el cual no se desactivará automáticamente. Esto te da tiempo para verificar que tu endpoint funciona correctamente antes de la siguiente evaluación.
</Accordion>

<Accordion title="Will I be notified when a webhook is auto-disabled?">
  Sí. Los usuarios del **plan Dev y superiores** reciben una notificación por correo electrónico cuando un webhook se desactiva automáticamente. Los usuarios del plan Free pueden monitorear el estado de sus webhooks en el [panel de Helius](https://dashboard.helius.dev/webhooks).
</Accordion>

<Accordion title="Can I disable a webhook without deleting it?">
  Sí. Puedes activar y desactivar webhooks desde el [panel de Helius](https://dashboard.helius.dev/webhooks) o mediante el [endpoint de la API para activar o desactivar webhooks](/docs/es/api-reference/webhooks/toggle-webhook). Esto te permite pausar temporalmente las entregas sin perder la configuración de tu webhook.
</Accordion>

## Solución de problemas de webhooks

<Accordion title="Why is my webhook dropping data?">
  La pérdida de datos suele ocurrir cuando tu endpoint encuentra un error, lo que provoca reintentos del webhook que finalmente fallan y causan la pérdida de datos. Revisa los registros de tu webhook en el [panel](https://dashboard.helius.dev/webhooks), asegúrate de tener suficientes registros del lado del cliente y [contacta al equipo de soporte](/docs/es/support/contact-support) si el problema persiste.
</Accordion>

<Accordion title="Why aren't my webhooks working?">
  Asegúrate de que el tipo de transacción seleccionado coincida con las transacciones que monitoreas. Comienza con el tipo de transacción "ANY" para determinar si se trata de un problema general o de una incompatibilidad de tipos. Usa [webhook.site](http://webhook.site/) para comprobar si el problema está en la configuración de tu endpoint.
</Accordion>

<Accordion title="Why does my webhook not send me all transactions of a certain type (such as TOKEN_MINT)?">
  El webhook `TOKEN_MINT` solo se activa para programas específicos como Candy Machine V1 y Solana Program Library. No abarca todos los eventos de acuñación de tokens en toda la blockchain. Para lograr un monitoreo más amplio, considera usar una suscripción más general a una cuenta o programa mediante webhooks con el filtro de tipo de transacción "ANY".
</Accordion>

***

## ¿Necesitas más ayuda?

<CardGroup cols={2}>
  <Card title="Contact Support" icon="headset" href="/docs/es/support/contact-support">
    Obtén ayuda de nuestro equipo mediante Discord, chat o correo electrónico.
  </Card>

  <Card title="Status Page" icon="wave-pulse" href="/docs/es/support/status-page">
    Consulta la disponibilidad del servicio y la información de rendimiento en tiempo real.
  </Card>
</CardGroup>