> ## Documentation Index > Fetch the complete documentation index at: https://developers.nuvia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Atualizar conversa > Atualiza os dados de uma conversa existente ## OpenAPI ````yaml https://api.nuvia.ai/api/docs/user-json put /v1/conversations/{id} openapi: 3.0.0 info: title: Nuvia API - Empresa description: Documentação da API para empresas version: '1.0' contact: {} servers: - url: https://api.nuvia.ai security: [] tags: - name: auth description: Autenticação paths: /v1/conversations/{id}: put: tags: - conversations summary: Atualizar conversa description: Atualiza os dados de uma conversa existente operationId: ConversationController_updateConversation parameters: - name: x-company-id in: header description: >- Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos. required: false schema: type: string - name: id required: true in: path description: ID da conversa schema: type: string requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateConversationDto' responses: '200': description: Conversa atualizada com sucesso content: application/json: schema: $ref: '#/components/schemas/ConversationResponseDto' '400': description: Dados inválidos '401': description: Token inválido ou expirado '403': description: Sem permissão para acessar este recurso '404': description: Recurso não encontrado security: - JWT-auth: [] components: schemas: UpdateConversationDto: type: object properties: additional_attributes: description: Atributos adicionais da conversa (chave-valor) type: object additionalProperties: {} custom_attributes: description: Atributos de sistema (deal vinculado, etc.) type: object properties: deal: description: Referência ao deal de CRM externo type: object properties: crm_type: type: string description: Tipo de CRM (hubspot, salesforce, etc.) crm_external_id: type: string description: ID do deal no CRM externo name: description: Nome do deal type: string amount: description: Valor do deal type: string stage: description: Estágio do deal type: string pipeline: description: Pipeline do deal type: string crm_last_synced_at: description: Data da última sincronização type: string required: - crm_type - crm_external_id - crm_last_synced_at additionalProperties: {} who_answering: type: string enum: - AGENT - HUMAN - UNASSIGNED description: Quem está respondendo (AGENT/HUMAN) agent: description: ID do agente type: string current_step_slug: description: Slug do passo atual type: string current_step: description: ID do passo atual do fluxo type: string requires_attention: description: Atenção necessária type: object properties: type: type: string enum: - HUMAN_HANDOFF - AI_SUPPORT_REQUEST - IDLE_CONVERSATION - CONTACT_MESSAGE description: Tipo de atenção necessária requested_at: description: Data da solicitação de atenção type: string required: - type - requested_at nullable: true contact_last_activity_at: description: Data da última atividade do contato type: string last_activity_at: description: Data da última atividade type: string allow_send_messages_at: description: Data até quando pode enviar mensagens (janela de 24h do WhatsApp) type: string referral: description: Dados de referral da conversa (anúncios, posts) type: object properties: source_url: type: string source_id: type: string source_type: type: string source_app: type: string title: type: string body: type: string media_type: anyOf: - type: string - type: number media_url: type: string thumbnail_url: type: string ctwa_clid: type: string welcome_message: type: object properties: text: type: string greeting_message: type: string conversion_source: type: string entry_point_app: type: string conversion_delay_seconds: type: number raw_data: type: object additionalProperties: {} status: description: Status da conversa type: string resume: description: Resumo da conversa gerado pelo specialist type: string temperature: description: Temperatura comercial classificada pelo specialist type: string enum: - HOT - WARM - COLD - CLOSED sentiment: description: Sentimento classificado pelo specialist type: string enum: - POSITIVE - NEUTRAL - NEGATIVE qualification: description: Qualificação BANT/GPCT/MEDDIC (specialist) type: object properties: methodology: type: string description: Metodologia (BANT/GPCT/MEDDIC/NONE) dimensions: type: array items: type: object properties: key: type: string label: type: string score: type: number summary: type: string required: - key additionalProperties: {} description: Dimensões da metodologia com score/summary required: - methodology - dimensions additionalProperties: {} lead_score: description: Lead score 0-100 baseado na qualificação + ICP type: number minimum: 0 maximum: 100 safety_scores: description: Safety scores (prompt injection, hallucination, etc.) type: object properties: prompt_injection: type: number harmful_content: type: number assertiveness: type: number hallucination: type: number additionalProperties: {} ConversationResponseDto: type: object properties: _id: type: string description: ID da conversa additional_attributes: description: Atributos adicionais da conversa agent_last_activity_at: description: Data da última atividade do agente contact_last_activity_at: description: Data da última atividade do contato allow_send_messages_at: description: Data permitida para enviar mensagens last_activity_at: description: Data da última atividade priority: description: Prioridade da conversa type: number enum: - 4 - 3 - 2 - 1 status: type: string enum: - OPEN - RESOLVED description: Status da conversa who_answering: type: string enum: - AGENT - HUMAN - UNASSIGNED description: Quem está respondendo (AGENT/HUMAN) contact: description: Contato da conversa inbox: description: Inbox da conversa agent: description: Agente atribuído à conversa current_step: description: Passo atual do fluxo do agente company: description: Empresa da conversa user: description: Usuário atribuído à conversa requires_attention: description: Atenção necessária type: object properties: type: type: string enum: - HUMAN_HANDOFF - AI_SUPPORT_REQUEST - IDLE_CONVERSATION - CONTACT_MESSAGE description: Tipo de atenção necessária requested_at: description: Data da solicitação de atenção required: - type - requested_at referral: description: Dados de referral da conversa createdAt: description: Data de criação da conversa updatedAt: description: Data de atualização da conversa resolved_count: description: >- Quantidade de conversas resolvidas do contato (apenas quando agrupado) type: number required: - last_activity_at - status - who_answering - contact - inbox - company securitySchemes: JWT-auth: scheme: bearer bearerFormat: JWT type: http description: Token JWT de autenticação ````