Ir al contenido principal

Documentación técnica del WebHook de Incenteev

Actualizado esta semana

Integra tus herramientas con Incenteev mediante WebHook para recibir información sobre nuevas publicaciones o nuevos comentarios

Introducción

El WebHook te permite recibir, ante un evento identificado, una solicitud HTTP POST a la URL configurada.

Esta solicitud siempre contiene un campo llamado “action” que define el evento que acaba de ocurrir.

Las nuevas publicaciones se identifican mediante una solicitud cuyo valor del campo action es feed_item_new.

Incluye el objeto feed_item (publicación), compuesto por varios campos y objetos (references, author, newsfeed).

Las modificaciones de publicaciones se identifican con la acción feed_item_edit e incluyen los mismos campos que la creación.

Las eliminaciones de publicaciones se identifican con la acción feed_item_delete e incluyen únicamente el identificador de la publicación.

Los nuevos comentarios se identifican con una solicitud cuyo valor del campo action es comment_new.

Incluye el objeto comment (comentario), compuesto por varios campos y objetos (references, author, newsfeed).

Las modificaciones de comentarios se identifican con la acción comment_edit e incluyen los mismos campos que en la creación.

Las eliminaciones de comentarios se identifican con comment_delete e incluyen únicamente el identificador del comentario.

A continuación, se detallan los distintos objetos:

Objeto: feed_item (publicación)

Nombre del objeto: feed_item

Objeto: comment (comentario)

Nombre del objeto: comment

Objeto: references (adjuntos)

Nombre del objeto: references

Objeto: author (autor)

Nombre del objeto: author

Objeto: newsfeed (feed de noticias)

Nombre del objeto: newsfeed

Ejemplos JSON

Nueva publicación

{
"action": "feed_item_new",
"feed_item": {
"id": 34,
"type": "post",
"body": "Hello\nGood morning!"
"date": "2018-07-12T15:19:21+00:00",
"from_mobile": false,
"url": “https://incenteev.my.incenteev.com/spaces/1/news-feed/34”,
"references": [
{
"type": "image",
"url": "https://incenteev.my.incenteev.com/spaces/515/files/78980",
"thumbnail": "https://incenteev-uploads.s3.amazonaws.com/media/1/image-b40e766116916873c91252426ce08fbf.png"
},
{
"type": "video",
"url": "https://incenteev.my.incenteev.com/spaces/515/files/77721",
"thumbnail": "https://incenteev-uploads.s3.amazonaws.com/media/1/f200e1e377c0c9bedc30b8436f10e47b.jpg"
}
],
"author": {
"id": 2,
"email": "test@company.com",
"name": "Jean Test"
"first_name": "Jean",
"last_name": "Test",
"profile_picture": "https://incenteev-uploads.s3.amazonaws.com/media/1/295285f8125f83b6bd53abded7b0a91d."
},
"newsfeed": {
"id": 1,
"name": "Discussions"
}
}
}

Nuevo comentario

{
"action": "comment_new",
"comment": {
"id": 87,
"body": "Good morning to you :)",
"date": "2018-07-13T04:42:14+00:00",
"from_mobile": true,
"references": [],
"author": {
"id": 2,
"email": "boss@company.com",
"name": "Steve Boss",
"first_name": "Steve",
"last_name": "Boss",
"profile_picture": "https://www.gravatar.com/avatar/1d86067b5ea4a0f4b832ea73cdb07e42?d=identicon&s=200"
},
"feed_item": {
"id": 34,
"url": "https://incenteev.my.incenteev.com/spaces/1/news-feed/34"
}
}
}

¿Ha quedado contestada tu pregunta?