Contenido de las notificaciones de webhook activadas por acciones en kintone

記事番号:040602

La activación de webhooks permite enviar notificaciones desde kintone en formato JSON.
Las tablas a continuación muestran los parámetros que se utilizan en las notificaciones activadas por cada evento.

Se agrega el registro / Se edita el registro / Se cambia el estado

ParámetroTipo de datosDescripción
idCadenaIndica un ID único que se asigna a cada notificación.
typeCadena

Indica el tipo de evento.
Se agrega registro: ADD_RECORD
El registro se edita: UPDATE_RECORD
El estado del registro ha cambiado: UPDATE_STATUS

appObjetoEl objeto que presenta información de la aplicación.
app.idCadenaアプリのIDです。
app.nameCadenaアプリ名です。
recordObjeto

El objeto que presenta información de registro.
El formato del objeto es el mismo que el de la API REST para recuperar los detalles de un registro.
Obtener registro

recordTitleCadena

Indica el título del registro.
Puede cambiar qué campo se utiliza como título del registro.
Establecer un campo de título

urlCadenaIndica el enlace permanente del registro.

Ejemplo de notificación

{
"id":"01234567-0123-0123-0123-0123456789ab",
"type":"ADD_RECORD",
"app":{
"id":"1",
"name":"Gestión de clientes potenciales"
},
"record":{
"Número de registro":{
"type":"RECORD_NUMBER",
"value":"2"
},
~~
"$revision":{
"type":"__REVISION__",
"value":"3"
},
"$id":{
"type":"__ID__",
"value":"2"
}
},
"recordTitle":"Visita: Cybozu, Inc.",
"url":"https://example.cybozu.com/k/1/show#record=2"
}

レコードの削除

ParámetroTipo de datosDescripción
idCadenaIndica un ID único que se asigna a cada notificación.
typeCadena

Indica el tipo de evento.
El registro se elimina: DELETE_RECORD

appObjetoEl objeto que presenta información de la aplicación.
app.idCadenaアプリのIDです。
app.nameCadenaアプリ名です。
recordIdCadenaIndica el número de registro. No incluye el código de la aplicación.
deletedByObjetoEl objeto que presenta información sobre el usuario que eliminó el registro.
deletedBy.codeCadenaユーザーのログイン名です。
deletedBy.nameCadenaIndica el nombre de usuario.
deletedAtCadenaIndica la fecha y hora en que se elimina el registro.

Ejemplo de notificación

{
"app":{
"id":"1",
"name":"Gestión de clientes potenciales"
},
"id":"01234567-0123-0123-0123-0123456789ab",
"recordId":"2",
"deletedBy":{
"code":"jones",
"name":"John Jones"
},
"deletedAt":"2017-07-03T09:38:09Z",
"type":"DELETE_RECORD"
}

コメントの書き込み

ParámetroTipo de datosDescripción
appObjetoEl objeto que presenta información de la aplicación.
app.idCadenaアプリのIDです。
app.nameCadenaアプリ名です。
commentObjeto

El objeto que presenta información sobre el comentario.
El formato del objeto es el mismo que el de la API REST utilizada para recuperar comentarios de registros.
Obtener comentarios

idCadenaIndica un ID único que se asigna a cada notificación.
recordIdCadenaIndica el número de registro. No incluye el código de la aplicación.
typeCadena

Indica el tipo de evento.
El comentario se publicó: ADD_RECORD_COMMENT

urlCadenaIndica el enlace permanente del comentario.

Ejemplo de notificación

{
"app":{
"id":"1",
"name":"Gestión de clientes potenciales"
},
"comment":{
"createdAt":"2012-02-03T09:38:09Z",
"creator":{
"code":"kato",
"name":"Misaki Kato"
},
"id":"11",
"mentions":[{
"code":"kato",
"type":"USER"
},{
"code":"org1",
"type":"ORGANIZATION"
},{
"code":"group1",
"type":"GROUP"
}],
"text":"Visité Cybozu, Inc. "
},
"id":"01234567-0123-0123-0123-0123456789ab",
"recordId":"2",
"type":"ADD_RECORD_COMMENT",
"url":"https://example.cybozu.com/k/1/show#record=2&comment=11"
}