Skip to main content
PUT
Atualizar conversa

Autorizações

Authorization
string
header
obrigatório

Token JWT de autenticação

Cabeçalhos

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.

Parâmetros de caminho

id
string
obrigatório

ID da conversa

Corpo

application/json
additional_attributes
object

Atributos adicionais da conversa (chave-valor)

custom_attributes
object

Atributos de sistema (deal vinculado, etc.)

who_answering
enum<string>

Quem está respondendo (AGENT/HUMAN)

Opções disponíveis:
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 | null

Atenção necessária

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)

status
string

Status da conversa

resume
string

Resumo da conversa gerado pelo specialist

temperature
enum<string>

Temperatura comercial classificada pelo specialist

Opções disponíveis:
HOT,
WARM,
COLD,
CLOSED
sentiment
enum<string>

Sentimento classificado pelo specialist

Opções disponíveis:
POSITIVE,
NEUTRAL,
NEGATIVE
qualification
object

Qualificação BANT/GPCT/MEDDIC (specialist)

lead_score
number

Lead score 0-100 baseado na qualificação + ICP

Intervalo obrigatório: 0 <= x <= 100
safety_scores
object

Safety scores (prompt injection, hallucination, etc.)

Resposta

Conversa atualizada com sucesso

last_activity_at
any
obrigatório

Data da última atividade

status
enum<string>
obrigatório

Status da conversa

Opções disponíveis:
OPEN,
RESOLVED
who_answering
enum<string>
obrigatório

Quem está respondendo (AGENT/HUMAN)

Opções disponíveis:
AGENT,
HUMAN,
UNASSIGNED
contact
any
obrigatório

Contato da conversa

inbox
any
obrigatório

Inbox da conversa

company
any
obrigatório

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

Opções disponíveis:
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

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)