Update Conversation

Lets you update the owners and status of a conversation.

PATCH https://api.platica.mx/v1/conversations/{conversationId}

URL parameters

ParameterTypeDescriptionRequired
conversationIdstringPublic identifier of the conversation

Request body

You must send at least one of the following fields:

FieldTypeDescription
ownersarrayList of responsible-user emails
statusstringNew conversation status

Example

{
  "owners": [
    "soporte@empresa.com",
    "ventas@empresa.com"
  ],
  "status": "finished"
}

Rules for owners

  • Must be sent as email addresses
  • Each email must exist as a workspace user

status transition rules

Allowed values: active, finished, spam, expired.

You can move freely between any state, except from expired, which is a final, irreversible state.

When the new state is expired, the customer's next contact will start a new conversation.

Response

{
  "status": "success",
  "message": "Conversation updated successfully",
  "data": {
    "ids": [
      "conv_001"
    ]
  }
}