Realizamos varios intentos para enviar un evento de webhook si la entrega inicial falla. Después del primer intento fallido, enviamos un correo electrónico a todos los administradores de tu cuenta para alertarles sobre el problema. Realizamos cinco intentos antes de eliminar el evento de la cola.
Si fallan eventos de webhook adicionales, desactivamos el webhook y enviamos otro correo electrónico a los administradores de tu cuenta.
Para obtener más información sobre cómo abordamos los errores de webhook, accede a la página de webhooks en nuestra documentación para desarrolladores y desplázate hasta Errores de webhook.
¿Qué provoca los errores de webhook?
Un error de webhook puede deberse a un problema con tu aplicación o servidor, o a que el webhook no esté configurado correctamente en Bitly. Un administrador de tu cuenta de Bitly puede confirmar que la configuración del webhook es correcta.
Para comprobar la configuración de tu webhook:
Este proceso utiliza la configuración de tu cuenta para comprobar la configuración de tu webhook. También puedes hacerlo a través de la API de Bitly.
- Inicia sesión en tu cuenta de Bitly.
- Haz clic en Configuración en la barra lateral izquierda.
- En la configuración de tu cuenta, haz clic en Webhooks.
- Haz clic en los tres puntos junto al webhook que estás solucionando y selecciona Editar.
- Confirma que la URL del punto de conexión es correcta.
- Si tu webhook requiere cumplimiento de OAuth, verifica que la configuración de tus proveedores de OAuth también sea correcta.
Si has confirmado la configuración en Bitly y has comprobado si hay problemas con tu aplicación y servidor, envía una solicitud a nuestro equipo de soporte para que podamos ayudarte a identificar y solucionar el problema.
Verifica tu webhook a través de la API.
Si tienes acceso a la API de Bitly y sabes cómo utilizarla, prueba tu webhook con nuestra herramienta de prueba de API. El punto de conexión de verificación de webhook envía un mensaje de evento de prueba a la URL del punto de conexión de tu webhook. Esto te ayuda a probar tu webhook sin necesidad de hacer clic o escanear un código QR.
La forma más fácil de probar es a través de tu terminal o símbolo del sistema favorito, con la herramienta de línea de comandos curl. También puedes usar aplicaciones como Postman, junto con nuestra colección de la API de Bitly para Postman. Estas instrucciones usan curl para verificar tu webhook.
- Genera un token de acceso.
- Si aún no tienes el identificador único global (GUID) de tu organización y el GUID del webhook, primero recopila esta información. Si tienes ambos, pasa al paso 3.
- Para encontrar tu OrgGUID, revisa la URL de tu navegador mientras estás en el menú de configuración de webhooks en tu cuenta de Bitly. En este ejemplo, el OrgGUID es
:org_guid. - Para encontrar tu webhook GUID, solicita los detalles de tu webhook a través de la API con una solicitud Get Webhooks. En la solicitud curl a continuación, reemplaza
{TOKEN}con tu token de acceso del paso 1 y:org_guidcon tu GUID del paso 2a. Encuentra el webhook GUID en la respuesta de curl.curl \
-H 'Authorization: Bearer {TOKEN}' \
-X GET \
https://api-ssl.bitly.com/v4/organizations/:org_guid/webhooks - Envía la solicitud curl a Verify Webhook. En la solicitud curl a continuación, reemplaza
{TOKEN}con tu token de acceso del paso 1 y:webhook_guidcon el GUID encontrado en el paso 2b.curl \
-H 'Authorization: Bearer {TOKEN}' \
-X POST \
https://api-ssl.bitly.com/v4/webhooks/:webhook_guid/verify - Este evento de prueba debería ayudarte a solucionar cualquier problema relacionado con el punto de conexión de tu webhook.
Si has confirmado la configuración en Bitly y has comprobado si hay problemas con tu aplicación y servidor, envía una solicitud a nuestro equipo de soporte para que podamos ayudarte a identificar y solucionar el problema.