Skip to main content

​
Créditos y límites de frecuencia

Hasta 100,000 direcciones mediante la API.
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.
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.
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.

​
Redes compatibles

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.
No; la URL debe ser accesible públicamente mediante HTTPS. Helius no puede acceder a servidores de desarrollo locales mediante URL de localhost.

​
Uso de webhooks

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.
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.
Los webhooks envían notificaciones inmediatamente después de que se confirma una transacción coincidente en la blockchain.

​
Reintentos

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.
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 para identificar fallas de entrega e investigar problemas con el endpoint.También ofrecemos políticas de reintento personalizables para los planes empresariales.
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.
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.

​
Desactivación automática

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.
  1. Corrige el problema subyacente de tu endpoint.
  2. Inicia sesión en el panel de Helius.
  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. Para ello, envía una solicitud PATCH con { "active": true }.
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.
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.
Sí. Puedes activar y desactivar webhooks desde el panel de Helius o mediante el endpoint de la API para activar o desactivar webhooks. Esto te permite pausar temporalmente las entregas sin perder la configuración de tu webhook.

​
Solución de problemas de webhooks

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, asegúrate de tener suficientes registros del lado del cliente y contacta al equipo de soporte si el problema persiste.
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 para comprobar si el problema está en la configuración de tu endpoint.
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”.

​
¿Necesitas más ayuda?

Contact Support

Obtén ayuda de nuestro equipo mediante Discord, chat o correo electrónico.

Status Page

Consulta la disponibilidad del servicio y la información de rendimiento en tiempo real.