Rispondere a un'interazione

Pubblica una risposta a una recensione o a un'interazione sulla piattaforma di origine (e.g. Google, Facebook). La risposta viene inviata in modo asincrono: interactionStatus è immediatamente CREATED e passa a COMPLETED o CONFIRMED quando la piattaforma ne conferma la ricezione (oppure a FAILED, vedi il flusso degli stati della risposta).

Non tutte le piattaforme supportano le risposte dei proprietari. Controlla canRespond nell'oggetto dell'interazione prima di effettuare la chiamata. Google Reviews accetta una sola risposta per recensione (un ulteriore tentativo restituisce SY50121); usa Modificare una risposta per modificare una risposta esistente anziché pubblicarne una nuova.

Caso d'uso: rispondere automaticamente alle nuove recensioni a 5 stelle

Per ringraziare automaticamente gli autori di recensioni positive, interroga periodicamente Elencare le interazioni con ratingFilters=[5] e responseStatus=["PENDING"], quindi, per ogni node restituito il cui canRespond è true, invia tramite POST il relativo id come interactionId con il tuo responseContent:

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

Poiché la pubblicazione è asincrona, recupera nuovamente l'interazione tramite Recuperare le interazioni per ID per confermare che la risposta abbia raggiunto COMPLETED/CONFIRMED anziché presumere che l'operazione sia riuscita sulla base di 200.