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

custom_fields
object

Atualiza valores de campos customizados da conversa, por slug. Cobre select/multi_select (valor = option_id, ou lista deles) e text (valor = a string). Para number/date, use additional_attributes, que preserva o tipo nativo. Validação atômica: valor inválido não grava nenhum campo e retorna 422. Os option_id saem de GET /v1/custom-fields/{id}/options.

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)