Mois: octobre 2016

Communiquez avec vos Groupes Office 365 grâce aux WebHooks

Citation Publié le Mis à jour le

Bonjour,

Microsoft a annoncé lors d’ Ignite 2016 la montée en puissance de la fonctionnalité Groupes dans Office 365.

Les WebHooks sont des appels HTTP POST pour prévenir de l’apparition d’un événement quelque part.

C’est d’ailleurs la technologie mère qui soutient tous les connecteurs des Groupes Office 365, lisez les lignes suivantes, vous allez comprendre pourquoi.

webhooks
Vous pouvez grâce aux WebHooks publier des messages dans les conversations des Groupes depuis n’importe où.

Quel est l’intérêt ?

L’intérêt et de pouvoir ouvrir la plateforme et la faire dialoguer avec vos applicatifs externes ou même la plateforme Office 365. Ne soyez pas trop verbeux, au risque de polluer les utilisateurs. Les cas d’usages peuvent être les suivants :

  • une erreur de gravité importante
  • un mail office 365 de priorité urgente envoyé par un client spécifique

Voici ce que vous obtiendrez dans l’onglet « Conversations » une fois les webhooks paramétrés :

sans-titre
Onglet « Conversations » d’un Groupe Office 365 avec un Webhook

Démarrez un WebHook lié à un Groupe Office 365.

Ceci se fait grâce à un connecteur, qui est accessible via l’onglet « Connecteurs » de votre Groupe :

snip_20161013143818

Il vous faut ensuite ajouter un WebHook entrant, en donnant « un nom » et éventuellement en choisissant un logo :

snip_20161013144442

Après ceci vous devez copier l’URL du WebHook généré, qui est unique pour votre Groupe Office 365 :

snip_20161013145021

 

 

l’URL est du type : https://outlook.office365.com/webhook/aaa-aaa/IncomingWebhook/aaa/aaa

Ne communiquez pas cette url elle est unique et le WebHook n’est pas authentifié. Au pire vous pouvez toujours le supprimer ou en recréer une autre. Vous pouvez créer plusieurs WebHook dans un Groupe, si vous avez à gérer plusieurs sources.

Testez le webhook

Vous pouvez utiliser hurl.it ou un outil en ligne de commande, curl (téléchargeable ici, croyez moi ne perdez pas de temps à le chercher ailleurs sur le net 😉

L’équipe dev outlook nous propose un excellent tutoriel pour utiliser curl via https://dev.outlook.com/Connectors/GetStarted je n’ai rien a y ajouter.

pour mémoire, la ligne de commande est :

SET WEBHOOKURL="https://outlook.office365.com/webhook/aaa-aaa/IncomingWebhook/aaa/aaa"

curl -H "Content-Type: application/json" -d "{\"text\": \"Hello World!\"}" %WEBHOOKURL%

Voici la correspondance complète des champs JSON avec l’affichage des WebHooks dans la conversation des groupes :

sans-titre001

{
"title": "Hello from curl",
"text": "Visitez le [Portail Dev Outlook](https://dev.outlook.com) pour en apprendre plus sur les Connecteurs Office 365!",
"themeColor": "EA4300",
"potentialAction": [{"@context": "https://schema.org",
                    "@type": "ViewAction",
                    "name": "Open Outlook Dev Center",
                    "target": ["https://dev.outlook.com"]}
                    ]
}

Lancez vous !

Les possibilités sont infinis, voici la liste de quelques liaisons envisageables et les outils …

via zapier.com (quel bel outil !)

Voici comment configurer l' »Action » dans zapier pour paramétrer « Webhooks by Zapier »

snip_20161018140636

via flow.microsoft.com

Voici la configuration qu’il faut appliquer dans flow à votre activité « HTTP » :

snip_20161018121826

via ifttt.com

Il faut ajouter le channel « Maker » dans votre « Recipie », et configurer les champs comme suit :

snip_20161018155609

via du code

Voici différentes manières de faire un appel à un WebHook avec du code, pour l’intégrer dans votre application préférée :

Technologie Code
PHP <!--?php
class OfficeSender {private $_url;
private $_jsonData;
public function __construct($url, $data)
{$this->_url = $url;
$this->_jsonData = $data;
}

public function sendRequest()
{
$ch = curl_init($this->_url);
$jsonDataEncoded = json_encode($this->_jsonData);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonDataEncoded);
curl_setopt($ch, CURLOPT_HTTPHEADER, array('Content-Type: application/json'));
$result = curl_exec($ch);
}
}
$url = 'https://outlook.office365.com/webhook/aaa-aaa/IncomingWebhook/aaa/aaa';
$data = array(
'text' => 'test', // you put summary or text as key
'title' => 'welcome from php'
);

$req = new OfficeSender($url, $data);
$req->sendRequest();
?>

Node.js SharePoint www.eliostruyf.com
Powershell Set-StrictMode -Version Latest

$webhookURI = "https://outlook.office365.com/webhook/aaa-aaa/IncomingWebhook/aaa/aaa"

$pjson = @{
"title" = "Hello from powershell";
"text" = "This is my message. Hello there!";
"themeColor" ="EA4300";
}

Invoke-WebRequest `
-Uri $webhookURI `
-Method "POST" `
-Body (ConvertTo-Json -Compress -InputObject $pjson)

Un grand merci à Toufik pour avoir testé et réalisé les scripts en PHP et NodeJS !

Sources :
webhook dans sharepoint
https://www.eliostruyf.com/sample-node-js-sharepoint-webhook-application-released/
https://dev.outlook.com/Connectors/GetStarted

Pour aller plus loin :

Webhooks Azure Automation

Publicités

Ignite 2016 – Nouveautés autour des Groupes Office 365

Citation Publié le Mis à jour le

Bonjour,

« Je groupe, tu groupes, nous groupons, ….  » a été le leitmotiv d’Iginite 2016. Sans y avoir moi même participé, je vous propose un petit aperçu en français de tout ce qui a été annoncé autour des Groupes Office 365.

groups_everywhere

Vous allez voir des Groupes partout dans @Office365…

Intégration dans la suite Office 365

Les Groupes doivent pouvoir être créés de plusieurs manières :

  • depuis Outlook 2016, OWA, via l’app Outlook Groups
  • depuis PowerShell (New-UnifiedGroup)
  • depuis SharePoint Online en même temps que la création d’un « site d’équipe »
  • depuis Planner, PowerBI, et intégrés avec Dynamics CRM

=> Il est donc primordiale de porter de l’attention au noms de vos groupes dés aujourd’hui, en préfixant ceux ci par un trigramme (cli_ pour client par exemple)

Administration et gouvernance

Un certain nombre de commandes PowerShell existent, notamment sur les droits d’administration d’un groupe, et le paramétrage avancée des fonctionnalités d’un groupe. Vous trouverez ici toutes les commandes PowerShell pour les groupes Office 365

Il existe aujourd’hui un script qui permet de supprimer les groupes inactifs ou peu utilisés que vous pouvez télécharger ici et un autre ici dans la gallery technet

Je fais quoi et quand (bonnes pratiques) ?

Il est admis que ceux qui souhaite déployer les Groupes doivent prendre cette décision en conscience. Il n’est pas possible de changer d’option aprés avoir choisi les groupes (et revenir à outlook ou yammer par exemple.

Le schéma ci dessous montre les différents types de collaboration qui existent au sein d’Office 365 :

  • centré sur les Mails: (Outlook) utiliser les Groupes Office 365 ou les listes de distributions traditionnelles,
  • centré sur les Documents: utiliser les Groupes Office 365 ou les sites d’équipes SharePoint,
  • centré sur les appels et conférences : utiliser Skype for Business,
  • parler à tout le monde : Groupes Office 365  (pour les petites entreprises) ou Yammer

yammer-collab-types-1280x725

En complément, vous pouvez créer un groupe :

  • si vous avez de nombreux emails à gérer
  • si vous devez partager de nombreux documents office
  • si vous utilisez actuellement une liste de distribution

mais vous ne devez pas créer pas de groupe :

  • si vous vous adressez à un public important (toute l’entreprise)
  • vous devez implémenter des niveaux de droits fins

Les groupes vont ils remplacer les sites d’équipes ?

La réponse de Microsoft est clairement « non » (« no » en anglais). Arrêtez de vous poser la question. Il existe de nombreux scénarios où les groupes ne sont pas justifiés (principalement car il n’y a qu’une seule bibliothèque pour les groupes). Les sites SharePoint restent le moyen de résoudre les problèmes de partage complexes, comme ceci à toujours été.

Les groupes précipitent-ils la fin de yammer ?

Depuis plusieurs on parle de la « fin » de Yammer. Yammer ne sera bientôt plus vendus en stand-alone et sera obligatoirement intégré aux plans Office 365.

L’intéraction entre les groupes Yammer et les Groupes Office 365 a été annoncée en Juin 2016. Seul les groupes Yammer nouvellement créés seront connecté aux Groupes Office 365. Si vous créez un groupe dans Yammer, la conversation restera dans Yammer.

à vous de vous faire votre propre avis 🙂

Les innovations à venir

Voici les principales nouveautés à attendre ces prochains mois pour les Groupes :

en terme d’utilisation et d’expérience utilisateur :

  • intégration avec les groupes yammer
  • intégration dans planner etendue
  • « envoyer en tant que » pour les boites mails partagées
  • support dans Outlook pour Mac
  • amélioration du trie et des notifications
  • amélioration de la vue sur les groupes
  • recherche transverse sur les groupes
  • intégration avec Skype
  • amélioration continue du rendu

Administration

  • mise en place d’une politique de nommage dans Azure Active Directory
  • membres cachés (groupes inviibles si pas d’accès)
  • statistiques d’utilisation générales
  • politique de rétention et de suppression
  • mise en place d’une corbeille (possiblité de restaurer un Groupe effacé)
  • convergences avec les Listes de Distributions
  • mise en place de fonctionnement hybrid

Sources :

https://www.petri.com/office-365-groups-news-ignite

https://thorildblog.wordpress.com/2016/10/04/microsoft-ignite-2016-atlanta-groups-what-up/

https://www.petri.com/yammer-office-365-groups