Atualizar conversa

curl --request PUT \ --url https://api.nuvia.ai/v1/conversations/{id} \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "additional_attributes": {}, "custom_attributes": {}, "agent": "<string>", "current_step_slug": "<string>", "current_step": "<string>", "requires_attention": { "requested_at": "<string>" }, "contact_last_activity_at": "<string>", "last_activity_at": "<string>", "allow_send_messages_at": "<string>", "referral": { "source_url": "<string>", "source_id": "<string>", "source_type": "<string>", "source_app": "<string>", "title": "<string>", "body": "<string>", "media_type": "<string>", "media_url": "<string>", "thumbnail_url": "<string>", "ctwa_clid": "<string>", "welcome_message": { "text": "<string>" }, "greeting_message": "<string>", "conversion_source": "<string>", "entry_point_app": "<string>", "conversion_delay_seconds": 123, "raw_data": {} }, "status": "<string>" } '

{ "last_activity_at": "<unknown>", "contact": "<unknown>", "inbox": "<unknown>", "company": "<unknown>", "_id": "<string>", "additional_attributes": "<unknown>", "agent_last_activity_at": "<unknown>", "contact_last_activity_at": "<unknown>", "allow_send_messages_at": "<unknown>", "agent": "<unknown>", "current_step": "<unknown>", "user": "<unknown>", "requires_attention": { "requested_at": "<unknown>" }, "referral": "<unknown>", "createdAt": "<unknown>", "updatedAt": "<unknown>", "resolved_count": 123 }

Authorizations

Authorization

string

header

required

Token JWT de autenticação

Headers

x-company-id

string

Identificador da empresa-alvo. Obrigatório apenas para API Keys globais (type=global). Ignorado para API Keys de empresa e usuários humanos.

Path Parameters

string

required

ID da conversa

Body

application/json

additional_attributes

object

Atributos adicionais da conversa (chave-valor)

Show child attributes

custom_attributes

object

Atributos de sistema (deal vinculado, etc.)

Show child attributes

who_answering

enum<string>

Quem está respondendo (AGENT/HUMAN)

Available options:

AGENT,

HUMAN,

UNASSIGNED

agent

string

ID do agente

current_step_slug

string

Slug do passo atual

current_step

string

ID do passo atual do fluxo

requires_attention

object

Atenção necessária

Show child attributes

contact_last_activity_at

string

Data da última atividade do contato

last_activity_at

string

Data da última atividade

allow_send_messages_at

string

Data até quando pode enviar mensagens (janela de 24h do WhatsApp)

referral

object

Dados de referral da conversa (anúncios, posts)

Show child attributes

status

string

Status da conversa

Response

Conversa atualizada com sucesso

last_activity_at

any

required

Data da última atividade

status

enum<string>

required

Status da conversa

Available options:

OPEN,

RESOLVED

who_answering

enum<string>

required

Quem está respondendo (AGENT/HUMAN)

Available options:

AGENT,

HUMAN,

UNASSIGNED

contact

any

required

Contato da conversa

inbox

any

required

Inbox da conversa

company

any

required

Empresa da conversa

_id

string

ID da conversa

additional_attributes

any

Atributos adicionais da conversa

agent_last_activity_at

any

Data da última atividade do agente

contact_last_activity_at

any

Data da última atividade do contato

allow_send_messages_at

any

Data permitida para enviar mensagens

priority

enum<number>

Prioridade da conversa

Available options:

4,

3,

2,

1

agent

any

Agente atribuído à conversa

current_step

any

Passo atual do fluxo do agente

user

any

Usuário atribuído à conversa

requires_attention

object

Atenção necessária

Show child attributes

referral

any

Dados de referral da conversa

createdAt

any

Data de criação da conversa

updatedAt

any

Data de atualização da conversa

resolved_count

number

Quantidade de conversas resolvidas do contato (apenas quando agrupado)