/api/v4/locations/reviews/respond/editEditar uma resposta a uma interação
Edita uma resposta do proprietário publicada anteriormente em uma avaliação ou interação.
Parâmetros
Corpo
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| responseId | string | obrigatório | ID of the response to edit (the `id` from an interaction's `responses` array). |
| reviewId | string | obrigatório | ID of the interaction the response belongs to. |
| responseContent | string | obrigatório | Updated text content of the response. |
| templateId | string | opcional | Response-template ID to re-attribute the edited reply to, if any. |
Exemplo de requisição
Corpo pronto para colar. Substitua os IDs e valores de exemplo pelos seus.
{ "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523", "responseContent": "Thank you again: we've updated our reply to include our new store hours."}Respostas
200Edit accepted and queued for re-submission. `data.editResponse` returns the identifiers.
{ "data": { "editResponse": { "status": "true", "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523" } }}401Unauthenticated, missing or invalid API key.
Atualiza o conteúdo de uma resposta existente do proprietário. A resposta editada é reenviada à plataforma de origem de forma assíncrona, seu interactionStatus volta para CREATED e passa para COMPLETED ou CONFIRMED assim que a plataforma confirma a atualização (consulte o fluxo de status da resposta).
Tanto reviewId (a interação) quanto responseId (a resposta específica) são obrigatórios. Obtenha o responseId a partir de responses[].id de uma interação usando Obter interações por IDs ou Listar interações.
Caso de uso: corrigir um erro de digitação em uma resposta publicada
Quando uma resposta publicada do proprietário contém um erro, edite-a diretamente em vez de arquivá-la e publicá-la novamente; isso preserva a resposta em plataformas (como o Google) que permitem apenas uma resposta por avaliação. Consulte o array responses da interação, obtenha o id da resposta a ser corrigida e execute POST:
{ "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523", "responseContent": "Thank you again: we've updated our reply to include our new store hours."}Um status de "true" significa que a edição foi aceita; consulte periodicamente Obter interações por IDs para confirmar que a resposta atualizada atinge CONFIRMED no site de origem.
curl -X POST 'https://listingsapi.com/api/v4/locations/reviews/respond/edit' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "reviewId": "9e26d2a8-a6ed-42ea-8454-47d1c92ea841", "responseId": "2090753a-ece6-4837-8336-8494ad308523", "responseContent": "Thank you again: we've updated our reply to include our new store hours." }'