Répondre à une interaction

Publie une réponse à un avis ou à une interaction sur sa plateforme d’origine (e.g. Google, Facebook). La réponse est envoyée de manière asynchrone : interactionStatus prend immédiatement la valeur CREATED, puis passe à COMPLETED ou à CONFIRMED une fois que la plateforme en accuse réception (ou à FAILED, voir le cycle des statuts de réponse).

Toutes les plateformes ne prennent pas en charge les réponses des propriétaires. Vérifiez canRespond dans l’objet d’interaction avant d’effectuer l’appel. Les avis Google n’acceptent qu’une seule réponse par avis (une nouvelle tentative renvoie SY50121) ; utilisez Modifier une réponse pour modifier une réponse existante au lieu d’en publier une nouvelle.

Cas d’utilisation : répondre automatiquement aux nouveaux avis à 5 étoiles

Pour remercier automatiquement les auteurs d’avis satisfaits, interrogez régulièrement Lister les interactions avec ratingFilters=[5] et responseStatus=["PENDING"], puis, pour chaque node renvoyé dont canRespond vaut true, utilisez POST pour envoyer son id en tant que interactionId avec votre responseContent :

{  "interactionId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841",  "responseContent": "Thank you for visiting Jenny Home: we're glad you enjoyed your experience!"}

Comme la publication est asynchrone, récupérez à nouveau l’interaction via Obtenir les interactions par leurs identifiants pour confirmer que la réponse a atteint le statut COMPLETED/CONFIRMED, au lieu de supposer que l’opération a réussi sur la seule base de 200.