Webhooks

Un webhook representa un destino de servicio, donde una notificación entrante se puede consumir mediante programación. Por ejemplo, una notificación recibida sobre un evento puede activar un destino de webhook hacia un microservicio de backend para que este actúe en función del contenido de la notificación recibida.

Configuración de un destino de webhook

Puedes configurar un destino de webhook en la pestaña « Destinos ». Como parte de la configuración, especifique el URL de webhook y el verbo de API REST que se invocará cuando se llame al webhook. También puede especificar cabeceras de autorización en el webhook de destino. Cree una suscripción para asociar el destino de webhook a un tema.

Verbos compatibles HTTP

Event Notifications los webhooks admiten los verbos http GET, POST, PUT y PATCH.

  • GET : Recupera una representación del recurso especificado.
  • POST: Crea un nuevo recurso.
  • PUT : Sustituye todo el recurso por los datos proporcionados.
  • PATCH : Aplica modificaciones parciales a un recurso.

Firma de webhook

Para identificar que la notificación entrante viene de IBM Cloud Event Notifications, puede habilitar la firma de webhook. Si la firma está habilitada, se puede descargar una clave pública y utilizarla para descifrar el contenido de la notificación recibida.

Lista de direcciones IP permitidas

Puedes añadir a la lista de permitidos los rangos de direcciones IP para restringir el acceso a los servidores que reciben webhooks. Asegúrate de que todas las siguientes direcciones IP estén incluidas en la lista de direcciones permitidas:

Direcciones IP de los webhooks existentes

Válido hasta finales de septiembre de 2026. Consulta las direcciones IP de los webhooks.

Direcciones IP nuevas

Con efecto a partir del 29 de agosto de 2026:

  • Direcciones IP comunes a nivel global: consulta las direcciones IP individuales para las regiones con varias zonas.

  • Direcciones IP específicas de cada región: Añade a la lista de permitidas las direcciones IP de la región en la que está implementada tu instancia del servicio Event Notifications. Si utilizas instancias del servicio « Event Notifications » en varias regiones, añade a la lista de permitidos las direcciones IP de cada una de las regiones correspondientes.

Dallas (us-south)

  • Público
   52.118.150.206
   52.118.211.163
   67.18.95.240
   ```
- Privado

  10.22.12.198
  10.22.26.163
  10.119.56.147
  ```

Sídney (au-syd)

  • Público
   159.23.97.10
   130.198.9.234
   135.90.131.19
   ```
- Privado

  10.223.237.137
  10.51.176.13
  10.223.253.235
  ```

London (eu-gb)

  • Público
   158.176.171.145
   158.175.189.21
   141.125.162.123
   ```
- Privado

  10.16.48.81
  10.16.62.205
  10.223.21.154
  ```

Madrid (eu-es)

  • Público
   13.121.86.163
   13.122.88.117
   13.120.93.85
   ```
- Privado

  10.22.177.232
  10.22.195.222
  10.22.202.91
  ```

Frankfurt (eu-de)

  • Público
   149.81.4.209
   149.81.212.50
   158.176.1.49
   ```
- Privado

  10.16.206.123
  10.22.112.128
  10.16.216.36
  ```

Osaka (jp-osa)

  • Público
   163.68.88.77
   163.69.84.115
   163.73.93.115
   ```
- Privado

  10.12.21.131
  10.12.33.173
  10.12.38.219
  ```

Tokyo (jp-tok)

  • Público
   165.192.134.77
   162.133.141.117
   128.168.131.96
   ```
- Privado

  10.223.197.48
  10.223.201.138
  10.223.213.141
  ```

Toronto (ca-tor)

  • Público
   163.74.90.220
   163.75.87.40
   163.66.93.241
   ```
- Privado

  10.223.149.61
  10.223.166.200
  10.223.182.99
  ```

Montreal (ca-mon)

  • Público
   64.5.42.20
   64.5.48.239
   64.5.44.233
   ```
- Privado

  10.46.73.140
  10.46.77.140
  10.46.81.140
  ```

Sao Paulo (br-sao)

  • Público
   13.116.82.0
   163.107.92.208
   163.109.92.155
   ```
- Privado

  10.12.183.145
  10.12.71.56
  10.51.193.111
  ```

Washington DC (us-east)

  • Público
   52.117.124.52
   169.63.177.17
   150.239.80.160
   ```
- Privado

  10.22.41.152
  10.22.50.51
  10.12.118.230
  ```

Chennai (in-che)

  • Público
   169.38.17.66
   169.38.9.38
   169.38.13.18
   ```
- Privado

  10.46.128.179
  10.46.132.179
  10.46.136.179
  ```

Mumbai (in-mum)

  • Público
   169.38.211.191
   169.38.236.49
   169.38.42.162
   ```
- Privado

  10.223.94.240
  10.223.103.208
  10.249.119.171
  ```

Política de reintentos de webhook

Cuando se llama a un webhook, problemas como errores de red y fallos de la aplicación pueden hacer que las solicitudes fallen. Event Notifications reintenta automáticamente las solicitudes fallidas para proporcionar resiliencia a las solicitudes externas.

Para obtener información detallada sobre el comportamiento de reintento, incluidos los intentos de reintento, los retrasos y los valores de tiempo de espera, consulte Política de reintento para destinos.

Probar una configuración de destino de webhook

Puedes probar un destino de webhook en el menú de opciones. Puedes comprobar si la configuración proporcionada para un destino es correcta o no con un solo clic.

Para obtener más información sobre cómo probar un destino, consulte Probar destinos.