WavUps CRM
Entrar
Conversas

Atualizar Conversa

Atualiza os dados de uma conversa externa (nome, telefone, username, setor, responsável e status).

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

Requisição

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

Tokenstringobrigatório

Seu token de autenticação.

idstringobrigatório

ID da conversa externa a ser atualizada.

Body Parameters

contactNamestring

Nome do contato da conversa.

contactPhonestring

Número de telefone do contato (ex: +5511999990000).

contactUsernamestring

Username do contato no canal (ex: handle do Instagram ou nome de usuário no WhatsApp).

accountChatSectorIdstring

ID do setor de chat a ser atribuído à conversa.

conversationOwnerIdstring

ID do usuário responsável. Esta propriedade define o responsável (leadOwner) no objeto Lead vinculado à conversa.

statusstring

Status da conversa. Deve ser active ou inactive.

statestring

Estado do atendimento da conversa. Valores aceitos: NEW, AI_ANSWERING, NEEDS_HUMAN, NO_RESPONSE, COMPLETED, ARCHIVED.

Resposta

Retorna o objeto da conversa atualizada, incluindo os dados do Lead e responsável vinculados.

idstring

Identificador único da conversa.

contactNamestring

Nome do contato da conversa.

contactPhonestring | null

Telefone do contato.

contactUsernamestring | null

Username do contato.

accountChatSectorIdstring | null

ID do setor de chat ao qual a conversa pertence.

statusstring

Status atualizado da conversa (active ou inactive).

statestring | null

Estado atual do atendimento 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).

AccountCRMLeadobject | null

Dados do Lead vinculado, incluindo o responsável atualizado (leadOwner).

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
contactPhonestring | null
contactUsernamestring | null
accountChatSectorIdstring | null
conversationOwnerIdstring | null

Define o responsável (leadOwner) no Lead associado.

statusenum<string>

Valores aceitos: active, inactive

Respostas

200application/json · object

Conversa atualizada 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>
400
404
500