Webhook

El conector de webhooks te permite escuchar eventos de tu backend que admiten webhooks. Este conector está diseñado para usarse con el activador de webhook. El activador de webhook recibe eventos de aplicaciones de terceros basadas en SaaS que admiten la capacidad de eventos de webhook. Este activador admite varios tipos de autenticación para tu objeto de escucha de eventos. Para usar el activador de webhook en tu integración, primero debes configurar un conector de webhook.

Antes de comenzar

Antes de usar el conector de webhook, realiza las siguientes tareas:

  • En tu proyecto de Google Cloud, haz lo siguiente:
    • Habilita los siguientes servicios:
      • secretmanager.googleapis.com (API de Secret Manager)
      • connectors.googleapis.com (API de conectores)

      Para comprender cómo habilitar servicios, consulta Habilita servicios.

    • Otorga los siguientes roles de IAM a la cuenta de servicio que quieres usar para el conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Una cuenta de servicio es un tipo de Cuenta de Google especial que representa a un usuario no humano. Estas cuentas deben autenticarse y tener autorización para acceder a los datos de las APIs de Google. Si no tienes una cuenta de servicio, debes crear una. Para obtener más información, consulta Crea una cuenta de servicio.

    Si estos servicios o permisos no se habilitaron antes para tu proyecto, se te solicitará que los habilites cuando configures el conector.

Configura el conector

Para configurar el conector, debes crear una conexión a tu fuente de datos (sistema de backend). Una conexión es específica de una fuente de datos. Significa que, si tienes muchas fuentes de datos, debes crear una conexión independiente para cada fuente. Para crear una conexión, sigue estos pasos:

  1. En la consola de Cloud, ve a la página Conectores de Integration > Conexiones y, luego, selecciona o crea un proyecto de Google Cloud.

    Ir a la página Conexiones

  2. Haz clic en + Crear nuevo para abrir la página Crear conexión.
  3. En la sección Ubicación, elige la ubicación para la conexión.
    1. Región: selecciona una ubicación de la lista desplegable.

      Para obtener la lista de todas las regiones compatibles, consulta Ubicaciones.

    2. Haz clic en Siguiente.
  4. En la sección Detalles de la conexión, completa lo siguiente:
    1. Conector: Selecciona Webhook en la lista desplegable de conectores disponibles.
    2. Versión del conector: Selecciona la versión del conector en la lista desplegable de versiones disponibles.
    3. Connection Name: Ingresa un nombre para la instancia Connection.

      Los nombres de las conexiones deben cumplir con los siguientes criterios:

      • Los nombres de las conexiones pueden usar letras, números o guiones.
      • Las letras deben estar en minúsculas.
      • Los nombres de las conexiones deben comenzar con una letra y terminar con una letra o un número.
      • Los nombres de las conexiones no pueden superar los 49 caracteres.
      • En el caso de los conectores que admiten la suscripción a eventos, los nombres de las conexiones no pueden comenzar con “goog” .
    4. Descripción: De manera opcional, ingresa una descripción para la instancia de conexión.
    5. Cuenta de servicio: Selecciona una cuenta de servicio que tenga los roles necesarios.
    6. Suscripción a eventos: La suscripción a eventos se habilitará de forma predeterminada y es obligatoria para el conector de webhook.
    7. De forma opcional, haz clic en + Agregar etiqueta para agregar una etiqueta a la conexión en forma de un par clave-valor.
    8. Haz clic en Siguiente.
  5. En la sección Detalles de la suscripción al evento, completa lo siguiente:
    1. Autenticación del objeto de escucha: Selecciona un tipo de autenticación para el objeto de escucha de eventos y, luego, ingresa los detalles relevantes.

      El objeto de escucha del webhook admite los siguientes tipos de autenticación:

    2. Ubicación del campo Tipo de evento: Es un campo obligatorio que indica la ubicación (encabezado, parámetro de consulta o cuerpo de la solicitud) en la que estará presente el tipo de evento asociado con la solicitud de evento entrante.
    3. Event Type Field Name: Campo obligatorio en la ubicación configurada que identifica el tipo de evento asociado con la solicitud de evento entrante.
      4. {
"event_type": "user.created",
...
// other request fields
...
}
       En el ejemplo anterior, el campo event_type en el cuerpo de la solicitud indica que la solicitud pertenece a un elemento "user.created". evento.
    4. Selecciona Habilitar conectividad privada para obtener una conectividad segura entre tu aplicación de backend y tu conexión. Si seleccionas esta opción, debes realizar pasos de configuración adicionales después de crear la conexión. Para obtener más información, consulta Conectividad privada para la suscripción a eventos.
    5. Ingresa la configuración de mensajes no entregados. Si configuras mensajes no entregados, la conexión escribe los eventos sin procesar al tema de Pub/Sub especificado. Ingresa los siguientes detalles:
      1. ID del proyecto de mensajes no entregados: Es el ID del proyecto de Google Cloud en el que configuraste el tema de mensajes no entregados de Pub/Sub.
      2. Tema de mensajes no entregados: es el tema de Pub/Sub en el que deseas escribir los detalles del evento sin procesar.
    6. Haz clic en Siguiente.
  6. Revisar: Revisa los detalles de conexión y autenticación del objeto de escucha.
  7. Haz clic en Crear.

Usa la conexión de webhook en una integración

Después de crear la conexión, estará disponible en la integración de Apigee y en la integración de aplicaciones. Puedes usar la conexión en una integración a través de la tarea Connectors.

  • Para comprender cómo crear y usar la tarea Conectores en la integración de Apigee, consulta Tarea Conectores.
  • Para comprender cómo crear y usar la tarea Connectors en la integración de aplicaciones, consulta Tarea Connectors.

Obtén ayuda de la Comunidad de Google Cloud

Puedes publicar tus preguntas y debatir sobre este conector en la comunidad de Google Cloud en Cloud Forums.

¿Qué sigue?