Conversas

Atualizar Status da Conversa

Atualiza o status de uma conversa externa específica para ativo (`active`) ou inativo (`inactive`).

PUT/account-external-conversation/{id}/update-status
curl --request PUT \
  --url 'https://crm.wavups.com/api/v1/account-external-conversation/clxyz123/update-status' \
  --header 'Token: SEU_TOKEN_DE_API' \
  --header 'Content-Type: application/json' \
  --data '{
    "status": "inactive"
  }'
{
  "id": "clxyz123",
  "contactName": "Maria Silva",
  "contactPhone": "+5511999990000",
  "accountChatSectorId": "csector001",
  "conversationOwnerId": "cuser789",
  "status": "inactive",
  "state": "NEW",
  "createdAt": "2025-09-15T10:00:00.000Z"
}

Requisição

PUT https://crm.wavups.com/api/v1/account-external-conversation/{id}/update-status

Tokenstringobrigatório

Seu token de autenticação.

idstringobrigatório

ID da conversa externa a ser atualizada.

statusstringobrigatório

Novo status da conversa. Deve ser active ou inactive.


Resposta

Retorna o objeto da conversa atualizada.

idstring

Identificador único da conversa.

Nome do contato da conversa.

contactPhonestring | null

Telefone do contato.

accountChatSectorIdstring | null

ID do setor de chat ao qual a conversa pertence.

conversationOwnerIdstring | null

ID do usuário responsável pela conversa.

statusstring

Status atualizado da conversa (active ou inactive).

statestring | null

Estado atual do atendimento da conversa. Este endpoint não altera este campo (apenas status); o valor retornado reflete o estado atual da conversa. Valores possíveis:

  • NEW: conversa recém-criada, ainda não iniciada.
  • AI_ANSWERING: a IA está respondendo automaticamente ao contato.
  • NEEDS_HUMAN: a conversa precisa de atendimento humano.
  • NO_RESPONSE: o contato não respondeu.
  • COMPLETED: o atendimento foi concluído.
  • ARCHIVED: a conversa foi arquivada.
createdAtstring

Data de criação da conversa (ISO 8601).


Autorização

Tokenstring · headerobrigatório

Token de autenticacao gerado na plataforma WavUps CRM.

Parâmetros de caminho

idstringobrigatório

Identificador único do recurso.

Corpo da requisição

application/json · object
statusenum<string>obrigatório

Novo status da conversa. Deve ser 'active' ou 'inactive'.

Valores aceitos: active, inactive

Respostas

200application/json · object

Status da conversa atualizado com sucesso.

idstring
contactNamestring | null
contactPhonestring | null
accountChatSectorIdstring | null
conversationOwnerIdstring | null
statusstring
stateenum<string> | null

Valores aceitos: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED

createdAtstring<date-time>
400application/json · object

Status inválido fornecido.

errorstring
Exemplo: "Recurso não encontrado."
404
500