PATCH
/
conversations
/
{id}
curl --request PATCH \
  --url https://dash.superagentes.ai/api/conversations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "title": "<string>",
  "priority": "LOW",
  "assigneeIds": [
    "<string>"
  ]
}'
{
  "id": "conversation-id-1",
  "title": "Novo título da conversa",
  "priority": "HIGH",
  "updatedAt": "2023-01-01T00:00:00.000Z",
  "assignees": [
    {
      "id": "organization-membership-id-1",
      "user": {
        "id": "user-id-1",
        "name": "Nome do Usuário 1"
      }
    },
    {
      "id": "organization-membership-id-2",
      "user": {
        "id": "user-id-2",
        "name": "Nome do Usuário 2"
      }
    }
  ]
}

​
Atualizar Conversa

Este endpoint permite atualizar informações de uma conversa específica, como título, prioridade e atribuições.

​
Casos de uso

  • Alterar o título de uma conversa para melhor organização
  • Atualizar a prioridade de uma conversa com base na urgência
  • Atribuir uma conversa a um ou mais membros da equipe
  • Gerenciar o fluxo de trabalho de atendimento

​
Exemplos de código

const updateConversation = async (conversationId, updateData) => {
  const response = await fetch(`https://dash.superagentes.ai/api/conversations/${conversationId}`, {
    method: 'PATCH',
    headers: {
      'Authorization': `Bearer ${seu_token_jwt}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(updateData)
  });
  
  const data = await response.json();
  return data;
};

// Exemplo de uso
updateConversation('conversation-id-1', {
  title: 'Novo título da conversa',
  priority: 'HIGH',
  assigneeIds: ['organization-membership-id-1', 'organization-membership-id-2']
});

​
Exemplo de resposta

{
  "id": "conversation-id-1",
  "title": "Novo título da conversa",
  "priority": "HIGH",
  "updatedAt": "2023-01-01T00:00:00.000Z",
  "assignees": [
    {
      "id": "organization-membership-id-1",
      "user": {
        "id": "user-id-1",
        "name": "Nome do Usuário 1"
      }
    },
    {
      "id": "organization-membership-id-2",
      "user": {
        "id": "user-id-2",
        "name": "Nome do Usuário 2"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

ID da conversa

Body

application/json

Response

200
application/json
Conversa atualizada

The response is of type object.