Skip to main content
POST
/
v1
/
conversations
Criar conversa
curl --request POST \
  --url https://api.nuvia.ai/v1/conversations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contactId": "<string>",
  "inboxId": "<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.

Body

application/json
contactId
string
required

ID do contato

Minimum string length: 1
inboxId
string
required

ID do inbox (caixa de entrada)

Minimum string length: 1

Response

Conversa criada 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

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)