--- title: "Buscar conversas" method: GET path: "/api/v1/conversations" tags: ["Conversas"] --- # Buscar conversas `GET /api/v1/conversations` ## Query parameters - `skip` number - `take` number - `search` string - `filter` ConversationFiltersDto - `opened` boolean — Valor booleano para conversas em aberto. Por padrão o valor é true, caso o valor seja false retorna todas as conversas (incluindo finalizadas) - `departments` string — ID ou Lista de IDs de departamentos. Este campo aceita um único ou uma lista de IDs separados por vírgula - `instances` string — ID ou Lista de IDs de instâncias. Este campo aceita um único ou uma lista de IDs separados por vírgula - `tags` string — ID ou lista de IDs de tags. Este campo aceita um ID ou uma lista de IDs de tags separados por vírgula - `stages` string — ID do stage. Este campo aceita um únido ID, referente a um estágio de pipeline - `attendants` string — ID ou Lista de IDs de atendentes. Este campo aceita um único ou uma lista de IDs separados por vírgula - `openWindow` 'last24h' | 'all' — Filtro de janela em aberto. Valores aceitos: 'last24h' (mensagens recebidas nas últimas 24 horas) ou 'all' (todas as conversas) ## Response `200` - object - `count` number, required - `data` ConversationDto[] - `id` string — ID da conversa - `createdAt` string, date-time — Data de início da conversa - `updatedAt` string, date-time — Data da última atualização da conversa - `deletedAt` string, date-time — Data de exclusão da conversa - `archivedAt` string, date-time — Data de ocultação da conversa - `name` string — Nome do lead da conversa - `description` string — Descrição atribuída a conversa - `imageURL` string — Url da imagem do contato - `isGroup` boolean — Valor boleano que indica se a conversa é com um grupo ou não - `automationEnabled` boolean — Valor boleano que indica se as automações estão habilitadas para essa conversa - `contact` ContactDto - `id` string — ID do contato - `createdAt` string, date-time — Data de criação do contato - `updatedAt` string, date-time — Data de atualização do contato - `name` string — Nome do contato salvo no Data Crazy - `imageURL` string — URL da imagem de perfil do contato - `contactId` string — ID do contato - `platform` string — Plataforma utilizada no contato - `externalId` string — ID exterdo do contato - `accountName` string — Nome do usuário na plataforma de contato, por exemplo nome no Instagram - `pending` boolean — Valor boleano que indica se a mensagem ainda está pendente de envio - `externalInfo` ContactExternalInfoDto - `tagIds` string[] — Lista de ID de tags recebida da fonte de dados - `stageIds` string[] — Lista de ID de stages recebida da fonte de dados - `pipelineIds` string[] — Lista de ID de stages recebida da fonte de dados - `instance` InstanceDto - `id` string — Identificador único da instância - `name` string — Nome da instância - `createdAt` string, date-time — Data de criação da instância - `updatedAt` string, date-time — Data de atualização da instância - `platform` string — Platforma da instância - `provider` string — Provedor da integração - `engine` string — Motor da instância - `config` object — Configurações adicionais da instância - `isActive` boolean — Indica se a instância está ativa - `webhook` string — Path do webhook - `status` string — Status da conexão - `errorCode` string — Código de erro da conexão com a instância - `errorMessage` string — Mensagem de erro da conexão com a instância - `deletedAt` string, date-time — Data de exclusão da instância - `attendants` string[] — ID ou lista de IDs referentes ao atendente da conversa - `lastMessageDate` string, date-time — Data da última mensagem da conversa, recebida ou enviada - `lastReceivedMessageDate` string, date-time — Data da última mensagem recebida na conversa - `lastSendedMessageDate` string, date-time — Data da última mensagem enviada na conversa - `currentDepartment` DepartmentDto - `id` string — ID do departamento - `tenantId` string — ID da empresa na qual a conversa está - `createdAt` string — Data de criação do departamento - `name` string — Nome do departamento - `color` string — Cor do departamento em formato hexadecimal - `main` boolean — Valor boleano que indica se o departamento é o departamento principal da empresa - `updatedAt` string — Data de atualização do departamento - `currentThread` ThreadDto - `id` string — 680fd3377b1a71ca8844f899 - `code` number — Código da thread - `startedAt` string, date-time — Data de início na thread - `finishedAt` string, date-time — Data de finalização da thread - `attendants` string[] — Atendentes na thread - `conversationId` string — 6808cd89c9968a7b8a41b9f7 - `conversation` ConversationDto — recursive - `department` DepartmentDto - `id` string — ID do departamento - `tenantId` string — ID da empresa na qual a conversa está - `createdAt` string — Data de criação do departamento - `name` string — Nome do departamento - `color` string — Cor do departamento em formato hexadecimal - `main` boolean — Valor boleano que indica se o departamento é o departamento principal da empresa - `updatedAt` string — Data de atualização do departamento - `durationInMs` number — Duração em milisegundos na thread - `waitTimeInMs` number — Tempo de espera em milisegundos na thread - `hidden` boolean - `finished` boolean — Valor boleano que indica se a conversa está finalizada - `isPending` boolean — Valor boleano que indica se a conversa possui mensagens pendentes - `sourceReferral` SourceReferralDto - `sourceId` string — ID referente fonte - `sourceUrl` string — Url referente fonte - `ctwaId` string — CTWA referente (Click to WhatsApp ID) - `lastMessageIsAutomation` boolean — Valor boleano que indica se a ultima mensagem enviada naquela conversa foi por uma automação --- [API](https://skmtc.dev/datacrazy/apis/api-crm-datacrazy.md) · [All operations](https://skmtc.dev/datacrazy/apis/api-crm-datacrazy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/datacrazy/api-crm-datacrazy/revisions/681f3b1fe7c8/schema)