Vai al contenuto principale

Documentazione tecnica Incenteev WebHook

Aggiornato questa settimana

Integra i tuoi strumenti con Incenteev tramite WebHook per ricevere informazioni in caso di nuove pubblicazioni o nuovi commenti

Introduzione

Il WebHook ti consente di ricevere, al verificarsi di un evento identificato, una richiesta HTTP POST all’URL configurato.

Questa richiesta contiene sempre un campo chiamato “action” che definisce l’evento che si è appena verificato.

Le nuove pubblicazioni sono identificate da una richiesta il cui valore del campo action è feed_item_new.

Questa comprende l’oggetto feed_item (pubblicazione), composto da diversi campi e oggetti (references, author, newsfeed).

Le modifiche alle pubblicazioni sono identificate dall’azione feed_item_edit e contengono gli stessi campi della creazione.

Le eliminazioni di pubblicazioni sono identificate dall’azione feed_item_delete e includono solo l’identificativo della pubblicazione.

I nuovi commenti sono identificati da una richiesta con l’azione comment_new, che include l’oggetto comment (commento), composto da diversi campi e oggetti (references, author, newsfeed).

Le modifiche ai commenti sono identificate da comment_edit e includono gli stessi campi della creazione.

Le eliminazioni di commenti sono indicate da comment_delete e contengono solo l’identificativo del commento.

Di seguito trovi i dettagli di ciascun oggetto:

Oggetto: feed_item (pubblicazione)

Nome dell’oggetto: feed_item

Oggetto: comment (commento)

Nome dell’oggetto: comment

Oggetto: references (allegati)

Nome dell’oggetto: references

Oggetto: author (autore)

Nome dell’oggetto: author

Oggetto: newsfeed (feed di notizie)

Nome dell’oggetto: newsfeed

Esempi JSON

Nuova pubblicazione

{
"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"
}
}
}

Nuovo commento

{
"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"
}
}
}

Hai ricevuto la risposta alla tua domanda?