Configuración de webhooks

記事番号:040600

kintoneでWebhookを利用すると、kintoneのアプリで特定の操作が行われた際に、その内容を指定した外部サービスに送信します。
たとえば、レコードが追加されたときにその内容をチャットサービスに投稿する、といった連携を、プログラムを書くことなく設定できます。

Cómo funcionan los webhooks

Al utilizar una herramienta de integración que permite el uso de webhooks, puede conectar kintone a los servicios compatibles con la herramienta.
Ejemplos de estas herramientas son Zapier, Microsoft Power Automate e IFTTT.

Figura: Cómo funcionan los webhooks

Al configurar webhooks en una aplicación kintone, puede configurar notificaciones para las siguientes acciones de la aplicación.

  • レコードの追加
  • Editar un registro
  • レコードの削除
  • Publicar un comentario
  • Actualización del estado (Cuando se actualiza el estado de 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 la siguiente página:
Contenido de las notificaciones de webhook activadas por acciones en kintone

Descripción general de la configuración de un webhook

Puede configurar un webhook siguiendo los pasos a continuación.

(1) Configure un disparador usando una herramienta de integración (por ejemplo, Zapier)
(2) Configurar un webhook en kintone
(3) Configure una acción utilizando la herramienta de integración

Configuración de ejemplo

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

Preparativos

Antes de configurar un webhook, realice los siguientes preparativos.

  • 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.

1) Configurar un disparador en Zapier

  1. Acceda al sitio web de Zapier y regístrese.
    Si ya tiene una cuenta Zapier, haga clic en Iniciar sesión para iniciar sesión en su cuenta.
    Sitio web de Zapier

  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.Captura de pantalla: Selección de un activador de webhook

  4. Seleccione Catch Hook en Evento y luego haga clic en Continuar.Captura de pantalla: Seleccionar "Atrapar gancho"

  5. En la pantalla que aparece a continuación, haga clic en Continuar.Captura de pantalla: La pantalla que aparece después de seleccionar un evento

  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.Captura de pantalla: El botón "Copiar" está resaltado

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

2) 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 Ver.
    Captura de pantalla: El ícono "Ajustes app" está resaltado

  2. En la pantalla de configuración de la aplicación, seleccione la pestaña Configuración de la aplicación y luego haga clic en Webhooks en Personalización e integración.

  3. En la pantalla Webhooks, haga clic en Agregar webhook.

  4. En la pantalla Nuevo webhook, ingrese una 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 activador en Zapier".
    Configurar un disparador en Zapier
    Eliminar "https://" al comienzo de la URL.
    Puede ingresar hasta 1.024 caracteres en el campo de entrada.Captura de pantalla: Se muestra 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 agrega el registro seleccionado.Captura de pantalla: Se muestra la sección "Eventos".

  7. Asegúrese de que la casilla de verificación Activar este webhook esté seleccionada.
    La casilla de verificación está seleccionada de forma predeterminada.

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

  9. En la pantalla Webhooks, haga clic en Configuración de la aplicación en el mensaje que se muestra en la parte superior de la pantalla o haga clic en Volver a la configuración de la aplicación que se muestra en la parte inferior izquierda de la pantalla.

  10. En la pantalla de configuración de la aplicación, haga clic en Act. app.

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

  12. Agrega un 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 Probar disparador.
    Captura de pantalla: se muestra "Disparador de prueba"

  14. Compruebe que la prueba sea exitosa. Luego, haga clic en "Continuar con el registro seleccionado".
    Si la prueba falla, intente probar el 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.

3) Configurar una acción en Zapier

  1. Cuando se muestre la pantalla para configurar una acción en Zapier, seleccione Gmail.
    Captura de pantalla: "Gmail" está resaltado

  2. Seleccione Enviar correo electrónico en Evento y luego haga clic en Continuar.
    Captura de pantalla: "Enviar correo electrónico" está seleccionado en "Evento".

  3. Seleccione una cuenta de Gmail y luego haga clic en Continuar.
    Si no ha iniciado sesión en Gmail, aparecerá una pantalla para que pueda iniciar sesión en Gmail.Captura de pantalla: Seleccionar una cuenta de Gmail

  4. Especifique la información que se enviará a la cuenta de Gmail.
    Introduce la cuenta de Gmail del destinatario en la sección "Para" y configura los demás elementos necesarios, como el asunto y el cuerpo del mensaje. A continuación, haz clic en "Continuar".
    Captura de pantalla: Configuración de la notificación que se enviará a una cuenta de Gmail

  5. Confirme la configuración que ha establecido y haga clic en Probar 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 ahora es válido.

Cambiar la configuración de un webhook en kintone

La configuración del webhook en kintone se puede modificar posteriormente. Los pasos son los siguientes.

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

  2. En la pantalla de configuración de la aplicación, seleccione la pestaña Configuración de la aplicación y luego haga clic en Webhooks en Personalización e integración.

  3. En la pantalla Webhooks, haga clic en el ícono Editar en la columna del extremo derecho del webhook cuya configuración desea cambiar.
    Captura de pantalla: El botón "Editar" está resaltado

  4. En la pantalla Editar webhook, edite la configuración y haga clic en Guardar.

  5. En la pantalla Webhooks, haga clic en Configuración de la aplicación en el mensaje que se muestra en la parte superior de la pantalla o haga clic en Volver a la configuración de la aplicación que se muestra en la parte inferior izquierda de la pantalla.

  6. En la pantalla de configuración de la aplicación, haga clic en Act. app.

  7. En el cuadro de diálogo Act. app, haga clic en Act. app.