---
title: "Retorna o estado da janela de conversa do chat"
method: GET
path: "/chat/{identificadorChat}/janela-conversa"
tags: ["Gerenciador"]
---

# Retorna o estado da janela de conversa do chat

`GET /chat/{identificadorChat}/janela-conversa`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/comunicador`
- URL: `https://integracao.cvcrm.com.br/api/v1/comunicador/chat/{identificadorChat}/janela-conversa`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization.
> Consulte o tutorial completo antes de fazer sua primeira chamada:
> [Como autenticar nas APIs do CV CRM (v3+ — Bearer Token)](https://desenvolvedor.cvcrm.com.br/docs/como-autenticar-nas-apis-do-cv-crm-com-bearer-token)

Retorna o estado da janela de conversa de um chat: se ele aceita envio de mensagens e
qual o prazo da sessão.

Use quando você abre um chat **sem ter a listagem em mãos** — ao entrar por uma
notificação push, por exemplo. Tendo a listagem, os mesmos campos já vêm em
`GET /{painel}/chats-ativos` (`chat_bloqueado` e `janela_fecha_em`) e esta chamada é
desnecessária.

`chatBloqueado` é a resposta pronta. A janela só existe nos canais marcados com
bloqueio após a sessão de 24h: abre no início da conversa e dura 24h, e o chat está
bloqueado quando a última mensagem trocada caiu fora dela. A comparação é entre essas
duas datas, **não com o relógio** — não refaça esse cálculo no cliente.

Todos os campos são **de saída**: este endpoint não recebe corpo nem aceita parâmetros
além do identificador na URL.

## Path parameters

- `identificadorChat` string, required

## Response `200`

Estado da janela de conversa retornado com sucesso

- object
  - `data` JanelaConversa: Estado da janela de conversa de um chat: se ele aceita envio de mensagens e qual o prazo da sessão. Os mesmos dados vêm embutidos em `GET /{painel}/chats-ativos`, nos campos `chat_bloqueado` e `janela_fecha_em`. Somente leitura.
    - `chatBloqueado` boolean: Indica se a janela de conversa está fechada e o chat não aceita mais envio de mensagens. É a resposta pronta — não recalcule a janela no cliente.
    - `janelaFechaEm` string, nullable: Prazo da sessão em `Y-m-d H:i:s` (`dataUltimaMensagemRecebida` + 24h). Informativo; nulo quando o canal não bloqueia após a sessão de 24h ou quando o cliente ainda não escreveu. Quem responde o bloqueio é `chatBloqueado`.
    - `dataUltimaMensagemRecebida` string, nullable: Última mensagem recebida do cliente, em `Y-m-d H:i:s` — é dela que a janela abre. Herdada nas trocas de atendente, porque transferir o atendimento não muda quando o cliente falou pela última vez.
    - `dataInicioConversa` string, nullable: Início da conversa, em `Y-m-d H:i:s`. Contexto do atendimento; não participa mais do cálculo da janela.
    - `dataUltimaMensagem` string, nullable: Última mensagem trocada, de qualquer lado, em `Y-m-d H:i:s`.
    - `aguardandoRespostaCliente` boolean: Indica que a conversa aguarda a resposta do cliente à mensagem ativa para abrir a sessão (regras da Meta). Mesma regra de `aguardando_resposta_cliente` em `GET /{painel}/chats-ativos`.
  - `status` string

## Other responses

- `400`: Chat não encontrado ou identificador inválido

---

[API](https://skmtc.dev/cvcrm/apis/comunicador.md) - [All operations](https://skmtc.dev/cvcrm/apis/comunicador/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/comunicador/revisions/83f3c9ab22fa?raw)