Configuración Webhooks

Article Number:040600

Al usar Webhooks en Kintone, puedes enviar automáticamente información sobre acciones específicas a un servicio externo especificado a medida que las acciones se llevan a cabo en las aplicaciones Kintone.
Por ejemplo, puedes hacer que el contenido de los registros se publique automáticamente en un servicio de chat cuando se agregan a Kintone. Una integración como esta se puede configurar sin escribir un programa.

Cómo funcionan Webhooks

Al utilizar una herramienta de integración que le permita utilizar Webhooks, puede conectar Kintone con varios servicios compatibles con la herramienta.
Algunos ejemplos de esta herramienta son Zapier, Microsoft Power Automate e IFTTT.

Figura: Cómo funcionan Webhooks

Al configurar Webhooks en una aplicación Kintone, puede configurar notificaciones para las siguientes acciones realizadas en la aplicación.

  • Agregar un registro
  • Editar un registro
  • Eliminar un registro
  • Publicar un comentario
  • Actualización del estado (Cuando se actualiza el estado de la gestión de procesos)

Para obtener detalles sobre los parámetros utilizados en las notificaciones de webhook que se activan mediante acciones en Kintone, consulte Contenido de Notificaciones de webhook activadas por Acciones en Kintone.

Procedimiento para configurar un Webhook

A continuación se muestra el procedimiento para configurar un Webhook.

  • Configurar un disparador usando una herramienta de integración (por ejemplo, Zapier)
  • Configurar un Webhook en Kintone
  • Configurar una acción usando la herramienta de integración

Ejemplo

Esta sección proporciona un ejemplo de uso de Zapier para configurar un webhook que envía una notificación a Gmail cuando se agrega un nuevo registro en Kintone.

Preparación

Como preparación para configurar un Webhook, lleve a cabo lo siguiente:

  • Crear una cuenta de Gmail
  • Crear una aplicación Kintone

Cuando su cuenta de Gmail y la aplicación Kintone estén listas, siga los pasos que se describen a continuación.

Configurar un disparador en Zapier

  1. Accede al sitio web de Zapier y regístrate.
    Si no tiene una cuenta de Zapier, cree una nueva o regístrese con su cuenta existente, como una cuenta de Google.

  2. Haga clic en Crear Zap en el sitio web de Zapier.

  3. En la pantalla para elegir un disparador, ingrese "Webhook" en el cuadro de búsqueda y haga clic en Webhooks de Zapier.Pantalla de configuración de Zapier

  4. Seleccionar Catch Hook en Evento y luego haga clic en Continuar.Pantalla de configuración de Zapier

  5. En la pantalla que aparece a continuación, haga clic en Continuar.Pantalla de configuración de Zapier

  6. Cuando se genere una URL de webhook, haga clic en Copiar.
    Pegue la URL copiada en algún lugar que tenga a mano, como un editor de texto.Pantalla de configuración de Zapier

A continuación, deberá configurar un webhook en Kintone. Mantenga abierto el sitio web de Zapier.

Configurar un Webhook en Kintone

  1. Haga clic en el ícono Ajustes app (el ícono con forma de engranaje) en la parte superior derecha de la pantalla "Vista".
    Captura de pantalla: El ícono "Ajustes app" está resaltado

  2. En la "Ajustes app " pantalla, seleccione la pestaña Ajustes app y luego haga clic en Webhooks en Personalización e integración.

  3. Haga clic en Añ. Webhook.

  4. Ingrese la descripción del Webhook que se configurará.
    La descripción que introduzcas aquí se mostrará en la lista de Webhooks. Puedes introducir hasta 64 caracteres.

  5. En el campo de entrada Punto final Webhook, pegue la URL que ha copiado en el Paso 6 de la sección "Configurar un disparador en Zapier".
    Elim. "https://" al comienzo de la URL que has pegado.
    Puede ingresar hasta 1.024 caracteres en el campo de entrada.La pantalla "Nuevo webhook"

  6. En la sección Eventos, especifique las acciones que activarán una notificación de webhook.
    En este ejemplo, Se ha añadido el registro seleccionado.La pantalla "Nuevo webhook"

  7. Seleccionar la casilla de verificación Activar este webhook.
    De forma predeterminada, la casilla de verificación está seleccionada.

  8. Haga clic en Guardar en la parte inferior derecha de la pantalla.

  9. Haga clic en Ajustes app en el mensaje que se muestra en la parte superior de la pantalla, o haga clic en Volver a Ajustes app que se muestra en la parte inferior izquierda de la pantalla.

  10. Haga clic en Act. app en la parte superior derecha de la pantalla.

  11. En el cuadro de diálogo de confirmación, haga clic en Act. app.

  12. Añadir nuevo registro en la aplicación Kintone para que puedas probar el disparador que has configurado en Zapier.

  13. Regrese al sitio web de Zapier y haga clic en Prueba disparador.
    Sitio web de Zapier

  14. Comprueba que la prueba se ha realizado correctamente. A continuación, haz clic en Continuar.
    Si la prueba falla, intente probar Prueba disparador varias veces.
    Si la prueba aún falla, verifique que la URL que copió y pegó en el campo de entrada Punto final Webhook sea correcta.

Configurar una acción en Zapier

  1. Cuando se muestre la pantalla para configurar una acción en Zapier, selecciona Gmail.Pantalla de configuración de Zapier

  2. Seleccionar Enviar correo electrónico en Evento y luego haga clic en Continuar.
    Pantalla de configuración de Zapier

  3. Seleccionar una cuenta de Gmail y luego haga clic en Continuar.
    Si no ha iniciado sesión en Gmail, aparecerá una pantalla para que inicie sesión en Gmail.Pantalla de configuración de Zapier

  4. Especifique la información que se enviará a la cuenta de Gmail.
    Ingresa la cuenta de Gmail del destinatario en la sección Para y configura otros elementos necesarios, como las secciones Asunto y Cuerpo. Luego, haz clic en Continuar.
    Pantalla de configuración de Zapier

  5. Confirme la configuración que ha establecido y haga clic en Prueba y Continuar.

  6. Haga clic en Publicar Zap.

  7. Verifique que el correo electrónico de notificación se envíe a la cuenta de Gmail del destinatario y haga clic en Publicar y activar.

El Zap ya es válido.

Cambiar la configuración de un Webhook en Kintone

La configuración de webhook en Kintone se puede cambiar más adelante. Para cambiar la configuración de un webhook, siga los pasos que se indican a continuación.

  1. Haga clic en el ícono Editar en la columna del extremo derecho del webhook cuya configuración desea cambiar.
    Cambiar la configuración de Webhooks

  2. Editar la configuración y haga clic en Guardar.

  3. Haga clic en Ajustes app en el mensaje que se muestra en la parte superior de la pantalla, o haga clic en Volver a Ajustes app que se muestra en la parte inferior izquierda de la pantalla.

  4. Haga clic en Act. app en la parte superior derecha de la pantalla.

  5. En el cuadro de diálogo de confirmación, haga clic en Act. app.