Actualizar el estado de la conversación

Utiliza la API toggle_status para cambiar el estado de una conversación específica. El servidor valida si el estado de destino es válido según la matriz de transición de estados STATUS_TRANSITIONS.

Método de solicitud

POST

URL de la solicitud

https://livedesk-api.engagelab.com/api/v2/accounts/conversations/{conversation_id}/toggle_status

Autenticación

Para obtener más información, consulta las instrucciones de autenticación en API Overview.

Solicitud

Ejemplo de solicitud

              
              curl -X POST 'https://livedesk-api.engagelab.com/api/v2/accounts/conversations/{conversation_id}/toggle_status' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic base64(api_key:api_secret)' \
-d '{
    "status": "resolved",
    "snoozed_until": 1715000000
}'

            

Encabezados de la solicitud

Parámetros de ruta

Parámetros del cuerpo de la solicitud

Valores enumerados de status

Matriz de transición de estados (STATUS_TRANSITIONS)

Restricciones clave

• resolved es el único estado previo requerido para pasar a closed: open, pending y snoozed no pueden cambiarse directamente a closed. Primero deben pasar a resolved antes de archivarse.
• closed solo puede volver a open: una conversación archivada no puede pasar directamente a otros estados activos, como resolved, pending o snoozed.
• Escribir el mismo estado es una operación idempotente: cuando el estado de destino coincide con el estado actual, se omite la validación y la solicitud se procesa correctamente de forma directa. No se activa ninguna devolución de llamada.
• La validación se implementa en la capa de modelo de ActiveRecord mediante validate :status_transition_allowed, if: :will_save_change_to_status?, y se aplica a todas las rutas de save!, update! y status= seguidas de save.

Respuesta

Respuesta correcta

HTTP 200:

              
              {
  "meta": {},
  "payload": {
    "success": true,
    "conversation_id": 45,
    "current_status": "resolved",
    "snoozed_until": null
  }
}

            

Parámetros de respuesta

Respuestas de error

Estructura de la respuesta 422

Infracción de la matriz de transición de estados (procedente de la validación de la capa de modelo y representada como full_messages por RequestExceptionHandler):

              
              {
  "message": "Status can't transition from open to closed",
  "attributes": ["status"]
}

            

Valor de estado desconocido (de CustomExceptions::Conversation::InvalidStatus):

              
              {
  "message": "Invalid conversation status: \"foo\" ('foo' is not a valid status)"
}

            

Valor no válido de snoozed_until (de CustomExceptions::Conversation::InvalidSnoozedUntil):

              
              {
  "message": "Invalid snoozed_until: \"not-a-timestamp\" (invalid date)"
}