Buscar conversas

curl --request GET \
  --url https://api.g1.datacrazy.io/api/v1/conversations \
  --header 'Authorization: Bearer <token>'

{
  "count": 100,
  "data": [
    {
      "id": "6808cd89c9968a7b8a41b9f7",
      "createdAt": "2025-04-23T11:22:49.143Z",
      "updatedAt": "2025-06-24T16:28:23.722Z",
      "deletedAt": "2025-12-24T16:31:59.531Z",
      "archivedAt": "2025-12-24T16:31:59.531Z",
      "name": "Patrick Almeida",
      "description": "Cliente solicitou contato para o mês de novembro",
      "imageURL": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e",
      "isGroup": true,
      "automationEnabled": true,
      "contact": {
        "id": "554799970654",
        "createdAt": "2024-12-19T14:21:42.164Z",
        "updatedAt": "2025-06-24T16:28:23.703Z",
        "name": "Angelica Schramm",
        "imageURL": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e",
        "contactId": "5547988367066",
        "platform": "WHATSAPP",
        "externalId": "1c3627f8-d6b9-42a9-b355-6977c04c969e",
        "accountName": "@AngelicaSchramm",
        "pending": true,
        "externalInfo": {
          "tagIds": "849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896",
          "stageIds": "6fda2a0d-5e7c-4c51-bf47-2c60f7d34283,2bc3d979-93a4-4e64-8903-5d9379d3de91",
          "pipelineIds": "3e409b29-0462-40b0-aef4-5eb6f0f2f89a,74c8e833-f681-4ed0-9ce6-e474e2d4b1a0"
        }
      },
      "instance": {
        "id": "507f1f77bcf86cd799439011",
        "name": "Instância atendimentos suporte",
        "createdAt": "2024-04-11T12:00:00.000Z",
        "updatedAt": "2024-04-11T14:30:00.000Z",
        "platform": "WHATSAPP",
        "provider": "WHATSAPP_CLOUD_API",
        "engine": "WHATSAPP_CLOUD_API_19",
        "config": {
          "endAutomationInterval": 15,
          "endTypingInterval": 1,
          "evolutionApiUrl": "https://evolution-evolution2.mcmoxg.easypanel.host",
          "evolutionInstanceId": "Instancia suporte",
          "evolutionInstanceToken": "78523FD522AA-97KD-8C0F-8138D5A84671",
          "listenGroups": false,
          "typeList": "buttons",
          "startAutomationInterval": 3,
          "startTypingInterval": 0,
          "typingInterval": false
        },
        "isActive": true,
        "webhook": "/webhooks/z-api/d129a692-e5ab-42b3-b0e4-90ad9a12b068/68597f2a95fb0298e5c128b5",
        "status": "CONNECTED",
        "errorCode": "429",
        "errorMessage": "Não foi possível se conectar com o provedor",
        "deletedAt": "2025-11-07T22:05:15.754Z"
      },
      "attendants": [
        {
          "id": "67632a6713d401dff6bf8672"
        }
      ],
      "lastMessageDate": "2025-06-23T21:18:59.068Z",
      "lastReceivedMessageDate": "2025-06-23T21:18:59.068Z",
      "lastSendedMessageDate": "2025-11-22T21:20:15.733Z",
      "currentDepartment": {
        "id": "6804203784ea2133a1e25bd0",
        "tenantId": "d9bd689a-bb7e-4552-b7f6-c7f7b8b73b2b",
        "createdAt": "2025-04-19T22:14:15.964Z",
        "name": "Pós-vendas",
        "color": "#FF2200",
        "main": true,
        "updatedAt": "2025-04-19T22:14:15.998Z"
      },
      "currentThread": {
        "id": "ID da thread",
        "code": "Código da thread",
        "startedAt": "Data de início da thread",
        "finishedAt": "Data de finalização da thread",
        "attendants": [
          "<string>"
        ],
        "conversationId": "ID da conversation",
        "department": {
          "id": "6804203784ea2133a1e25bd0"
        },
        "durationInMs": "Duraçao em milisegundos na thread",
        "waitTimeInMs": "Tempo de espera em milisegundos na thread"
      },
      "hidden": "false",
      "finished": true,
      "isPending": false,
      "sourceReferral": {
        "sourceId": "2bc3d979-93a4-4e64-8903-5d9379d3de91",
        "sourceUrl": "https://example.com/artigo-de-origem",
        "ctwaId": "849fefab-e697-4720-9303-e788c23790cc"
      },
      "lastMessageIsAutomation": true
    }
  ]
}

GET

api

conversations

Buscar conversas

curl --request GET \
  --url https://api.g1.datacrazy.io/api/v1/conversations \
  --header 'Authorization: Bearer <token>'

{
  "count": 100,
  "data": [
    {
      "id": "6808cd89c9968a7b8a41b9f7",
      "createdAt": "2025-04-23T11:22:49.143Z",
      "updatedAt": "2025-06-24T16:28:23.722Z",
      "deletedAt": "2025-12-24T16:31:59.531Z",
      "archivedAt": "2025-12-24T16:31:59.531Z",
      "name": "Patrick Almeida",
      "description": "Cliente solicitou contato para o mês de novembro",
      "imageURL": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e",
      "isGroup": true,
      "automationEnabled": true,
      "contact": {
        "id": "554799970654",
        "createdAt": "2024-12-19T14:21:42.164Z",
        "updatedAt": "2025-06-24T16:28:23.703Z",
        "name": "Angelica Schramm",
        "imageURL": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e",
        "contactId": "5547988367066",
        "platform": "WHATSAPP",
        "externalId": "1c3627f8-d6b9-42a9-b355-6977c04c969e",
        "accountName": "@AngelicaSchramm",
        "pending": true,
        "externalInfo": {
          "tagIds": "849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896",
          "stageIds": "6fda2a0d-5e7c-4c51-bf47-2c60f7d34283,2bc3d979-93a4-4e64-8903-5d9379d3de91",
          "pipelineIds": "3e409b29-0462-40b0-aef4-5eb6f0f2f89a,74c8e833-f681-4ed0-9ce6-e474e2d4b1a0"
        }
      },
      "instance": {
        "id": "507f1f77bcf86cd799439011",
        "name": "Instância atendimentos suporte",
        "createdAt": "2024-04-11T12:00:00.000Z",
        "updatedAt": "2024-04-11T14:30:00.000Z",
        "platform": "WHATSAPP",
        "provider": "WHATSAPP_CLOUD_API",
        "engine": "WHATSAPP_CLOUD_API_19",
        "config": {
          "endAutomationInterval": 15,
          "endTypingInterval": 1,
          "evolutionApiUrl": "https://evolution-evolution2.mcmoxg.easypanel.host",
          "evolutionInstanceId": "Instancia suporte",
          "evolutionInstanceToken": "78523FD522AA-97KD-8C0F-8138D5A84671",
          "listenGroups": false,
          "typeList": "buttons",
          "startAutomationInterval": 3,
          "startTypingInterval": 0,
          "typingInterval": false
        },
        "isActive": true,
        "webhook": "/webhooks/z-api/d129a692-e5ab-42b3-b0e4-90ad9a12b068/68597f2a95fb0298e5c128b5",
        "status": "CONNECTED",
        "errorCode": "429",
        "errorMessage": "Não foi possível se conectar com o provedor",
        "deletedAt": "2025-11-07T22:05:15.754Z"
      },
      "attendants": [
        {
          "id": "67632a6713d401dff6bf8672"
        }
      ],
      "lastMessageDate": "2025-06-23T21:18:59.068Z",
      "lastReceivedMessageDate": "2025-06-23T21:18:59.068Z",
      "lastSendedMessageDate": "2025-11-22T21:20:15.733Z",
      "currentDepartment": {
        "id": "6804203784ea2133a1e25bd0",
        "tenantId": "d9bd689a-bb7e-4552-b7f6-c7f7b8b73b2b",
        "createdAt": "2025-04-19T22:14:15.964Z",
        "name": "Pós-vendas",
        "color": "#FF2200",
        "main": true,
        "updatedAt": "2025-04-19T22:14:15.998Z"
      },
      "currentThread": {
        "id": "ID da thread",
        "code": "Código da thread",
        "startedAt": "Data de início da thread",
        "finishedAt": "Data de finalização da thread",
        "attendants": [
          "<string>"
        ],
        "conversationId": "ID da conversation",
        "department": {
          "id": "6804203784ea2133a1e25bd0"
        },
        "durationInMs": "Duraçao em milisegundos na thread",
        "waitTimeInMs": "Tempo de espera em milisegundos na thread"
      },
      "hidden": "false",
      "finished": true,
      "isPending": false,
      "sourceReferral": {
        "sourceId": "2bc3d979-93a4-4e64-8903-5d9379d3de91",
        "sourceUrl": "https://example.com/artigo-de-origem",
        "ctwaId": "849fefab-e697-4720-9303-e788c23790cc"
      },
      "lastMessageIsAutomation": true
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

skip

number

take

number

string

filter

object

Show child attributes

filter.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)

Example:

true

filter.departments

string

ID ou Lista de IDs de departamentos.

Este campo aceita um único ou uma lista de IDs separados por vírgula

Example:

"e3581d38-aeab-483a-8275-de32dce2388a"

filter.instances

string

ID ou Lista de IDs de instâncias.

Este campo aceita um único ou uma lista de IDs separados por vírgula

Example:

"682f0a3823f2d4e36a2150c0,6808667d911e4c8975bc5405"

filter.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

Example:

"849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

filter.stages

string

ID do stage.

Este campo aceita um únido ID, referente a um estágio de pipeline

Example:

"849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

filter.attendants

string

ID ou Lista de IDs de atendentes.

Este campo aceita um único ou uma lista de IDs separados por vírgula

Example:

"849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896"

Response

200 - application/json

count

number

required

Example:

100

data

object[]

Show child attributes

data.id

string

ID da conversa

Example:

"6808cd89c9968a7b8a41b9f7"

data.createdAt

string<date-time>

Data de início da conversa

Example:

"2025-04-23T11:22:49.143Z"

data.updatedAt

string<date-time>

Data da última atualização da conversa

Example:

"2025-06-24T16:28:23.722Z"

data.deletedAt

string<date-time>

Data de exclusão da conversa

Example:

"2025-12-24T16:31:59.531Z"

data.archivedAt

string<date-time>

Data de ocultação da conversa

Example:

"2025-12-24T16:31:59.531Z"

data.name

string

Nome do lead da conversa

Example:

"Patrick Almeida"

data.description

string

Descrição atribuída a conversa

Example:

"Cliente solicitou contato para o mês de novembro"

data.imageURL

string

Url da imagem do contato

Example:

"https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e"

data.isGroup

boolean

Valor boleano que indica se a conversa é com um grupo ou não

Example:

true

data.automationEnabled

boolean

Valor boleano que indica se as automações estão habilitadas para essa conversa

Example:

true

data.contact

object

Informações do contato da conversa

Show child attributes

data.contact.id

string

ID do contato

Example:

"6808cd89c9968a7b8a41b9f7"

data.contact.createdAt

string<date-time>

Data de criação do contato

Example:

"2024-12-19T14:21:42.164Z"

data.contact.updatedAt

string<date-time>

Data de atualização do contato

Example:

"2025-06-24T16:28:23.703Z"

data.contact.name

string

Nome do contato salvo no Data Crazy

Example:

"Angelica Schramm"

data.contact.imageURL

string

URL da imagem de perfil do contato

Example:

"https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e"

data.contact.contactId

string

ID do contato

Example:

"5547988367066"

data.contact.platform

string

Plataforma utilizada no contato

Example:

"WHATSAPP"

data.contact.externalId

string

ID exterdo do contato

Example:

"1c3627f8-d6b9-42a9-b355-6977c04c969e"

data.contact.accountName

string

Nome do usuário na plataforma de contato, por exemplo nome no Instagram

Example:

"@AngelicaSchramm"

data.contact.pending

boolean

Valor boleano que indica se a mensagem ainda está pendente de envio

Example:

true

data.contact.externalInfo

object

Informações externas de alguma fonte de dados

Show child attributes

data.contact.externalInfo.tagIds

string[]

Lista de ID de tags recebida da fonte de dados

Example:

[
  "849fefab-e697-4720-9303-e788c23790cc",
  "9e008d34-86d2-49fd-90af-34a9f9b29896"
]

data.contact.externalInfo.stageIds

string[]

Lista de ID de stages recebida da fonte de dados

Example:

[
  "6fda2a0d-5e7c-4c51-bf47-2c60f7d34283",
  "2bc3d979-93a4-4e64-8903-5d9379d3de91"
]

data.contact.externalInfo.pipelineIds

string[]

Lista de ID de stages recebida da fonte de dados

Example:

[
  "3e409b29-0462-40b0-aef4-5eb6f0f2f89a",
  "74c8e833-f681-4ed0-9ce6-e474e2d4b1a0"
]

Example:

{
  "id": "554799970654",
  "createdAt": "2024-12-19T14:21:42.164Z",
  "updatedAt": "2025-06-24T16:28:23.703Z",
  "name": "Angelica Schramm",
  "imageURL": "https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/df4db2b8-7f0f-44d4-88e1-dd3e838f275e",
  "contactId": "5547988367066",
  "platform": "WHATSAPP",
  "externalId": "1c3627f8-d6b9-42a9-b355-6977c04c969e",
  "accountName": "@AngelicaSchramm",
  "pending": true,
  "externalInfo": {
    "tagIds": "849fefab-e697-4720-9303-e788c23790cc,9e008d34-86d2-49fd-90af-34a9f9b29896",
    "stageIds": "6fda2a0d-5e7c-4c51-bf47-2c60f7d34283,2bc3d979-93a4-4e64-8903-5d9379d3de91",
    "pipelineIds": "3e409b29-0462-40b0-aef4-5eb6f0f2f89a,74c8e833-f681-4ed0-9ce6-e474e2d4b1a0"
  }
}

data.instance

object

Informações do contato da conversa

Show child attributes

data.instance.id

string

Identificador único da instância

Example:

"507f1f77bcf86cd799439011"

data.instance.name

string

Nome da instância

Example:

"Instância atendimentos suporte"

data.instance.createdAt

string<date-time>

Data de criação da instância

Example:

"2024-04-11T12:00:00.000Z"

data.instance.updatedAt

string<date-time>

Data de atualização da instância

Example:

"2024-04-11T14:30:00.000Z"

data.instance.platform

string

Platforma da instância

Example:

"WHATSAPP"

data.instance.provider

string

Provedor da integração

Example:

"WHATSAPP_CLOUD_API"

data.instance.engine

string

Motor da instância

Example:

"WHATSAPP_CLOUD_API_19"

data.instance.config

object

Configurações adicionais da instância

Example:

{
  "endAutomationInterval": 15,
  "endTypingInterval": 1,
  "evolutionApiUrl": "https://evolution-evolution2.mcmoxg.easypanel.host",
  "evolutionInstanceId": "Instancia suporte",
  "evolutionInstanceToken": "78523FD522AA-97KD-8C0F-8138D5A84671",
  "listenGroups": false,
  "typeList": "buttons",
  "startAutomationInterval": 3,
  "startTypingInterval": 0,
  "typingInterval": false
}

data.instance.isActive

boolean

Indica se a instância está ativa

Example:

true

data.instance.webhook

string

Path do webhook

Example:

"/webhooks/z-api/d129a692-e5ab-42b3-b0e4-90ad9a12b068/68597f2a95fb0298e5c128b5"

data.instance.status

string

Status da conexão

Example:

"CONNECTED"

data.instance.errorCode

string

Código de erro da conexão com a instância

Example:

"429"

data.instance.errorMessage

string

Mensagem de erro da conexão com a instância

Example:

"Não foi possível se conectar com o provedor"

data.instance.deletedAt

string<date-time>

Data de exclusão da instância

Example:

"2025-11-07T22:05:15.754Z"

data.attendants

string[]

ID ou lista de IDs referentes ao atendente da conversa

Example:

[{ "id": "67632a6713d401dff6bf8672" }]

data.lastMessageDate

string<date-time>

Data da última mensagem da conversa, recebida ou enviada

Example:

"2025-06-23T21:18:59.068Z"

data.lastReceivedMessageDate

string<date-time>

Data da última mensagem recebida na conversa

Example:

"2025-06-23T21:18:59.068Z"

data.lastSendedMessageDate

string<date-time>

Data da última mensagem enviada na conversa

Example:

"2025-11-22T21:20:15.733Z"

data.currentDepartment

object

Departamento em que a conversa está

Show child attributes

data.currentDepartment.id

string

ID do departamento

Example:

"6804203784ea2133a1e25bd0"

data.currentDepartment.tenantId

string

ID da empresa na qual a conversa está

Example:

"d9bd689a-bb7e-4552-b7f6-c7f7b8b73b2b"

data.currentDepartment.createdAt

string

Data de criação do departamento

Example:

"2025-04-19T22:14:15.964Z"

data.currentDepartment.name

string

Nome do departamento

Example:

"Pós-vendas"

data.currentDepartment.color

string

Cor do departamento em formato hexadecimal

Example:

"#FF2200"

data.currentDepartment.main

boolean

Valor boleano que indica se o departamento é o departamento principal da empresa

Example:

true

data.currentDepartment.updatedAt

string

Data de atualização do departamento

Example:

"2025-04-19T22:14:15.998Z"

Example:

{
  "id": "6804203784ea2133a1e25bd0",
  "tenantId": "d9bd689a-bb7e-4552-b7f6-c7f7b8b73b2b",
  "createdAt": "2025-04-19T22:14:15.964Z",
  "name": "Pós-vendas",
  "color": "#FF2200",
  "main": true,
  "updatedAt": "2025-04-19T22:14:15.998Z"
}

data.currentThread

object

Thread referente a conversa

Show child attributes

data.currentThread.id

string

680fd3377b1a71ca8844f899

Example:

"ID da thread"

data.currentThread.code

number

Código da thread

Example:

115

data.currentThread.startedAt

string<date-time>

Data de início na thread

Example:

"2025-06-23T21:18:59.042Z"

data.currentThread.finishedAt

string<date-time>

Data de finalização da thread

Example:

"2025-12-28T21:12:59.0631Z"

data.currentThread.attendants

string[]

Atendentes na thread

data.currentThread.conversationId

string

6808cd89c9968a7b8a41b9f7

Example:

"ID da conversation"

data.currentThread.conversation

any

data.currentThread.department

object

3e409b29-0462-40b0-aef4-5eb6f0f2f89a

Show child attributes

data.currentThread.department.id

string

ID do departamento

Example:

"6804203784ea2133a1e25bd0"

data.currentThread.department.tenantId

string

ID da empresa na qual a conversa está

Example:

"d9bd689a-bb7e-4552-b7f6-c7f7b8b73b2b"

data.currentThread.department.createdAt

string

Data de criação do departamento

Example:

"2025-04-19T22:14:15.964Z"

data.currentThread.department.name

string

Nome do departamento

Example:

"Pós-vendas"

data.currentThread.department.color

string

Cor do departamento em formato hexadecimal

Example:

"#FF2200"

data.currentThread.department.main

boolean

Valor boleano que indica se o departamento é o departamento principal da empresa

Example:

true

data.currentThread.department.updatedAt

string

Data de atualização do departamento

Example:

"2025-04-19T22:14:15.998Z"

data.currentThread.durationInMs

number

Duração em milisegundos na thread

Example:

"6412432"

data.currentThread.waitTimeInMs

number

Tempo de espera em milisegundos na thread

Example:

"4845963"

Example:

{
  "id": "ID da thread",
  "code": "Código da thread",
  "startedAt": "Data de início da thread",
  "finishedAt": "Data de finalização da thread",
  "attendants": ["<string>"],
  "conversationId": "ID da conversation",
  "department": { "id": "6804203784ea2133a1e25bd0" },
  "durationInMs": "Duraçao em milisegundos na thread",
  "waitTimeInMs": "Tempo de espera em milisegundos na thread"
}

data.hidden

boolean

Example:

"false"

data.finished

boolean

Valor boleano que indica se a conversa está finalizada

Example:

true

data.isPending

boolean

Valor boleano que indica se a conversa possui mensagens pendentes

Example:

false

data.sourceReferral

object

Dados que indicam como um cliente chegou a iniciar uma conversa com sua empresa através de um anúncio

Show child attributes

data.sourceReferral.sourceId

string

ID referente fonte

Example:

"2bc3d979-93a4-4e64-8903-5d9379d3de91"

data.sourceReferral.sourceUrl

string

Url referente fonte

Example:

"https://example.com/artigo-de-origem"

data.sourceReferral.ctwaId

string

CTWA referente (Click to WhatsApp ID)

Example:

"849fefab-e697-4720-9303-e788c23790cc"

Example:

{
  "sourceId": "2bc3d979-93a4-4e64-8903-5d9379d3de91",
  "sourceUrl": "https://example.com/artigo-de-origem",
  "ctwaId": "849fefab-e697-4720-9303-e788c23790cc"
}

data.lastMessageIsAutomation

boolean

Valor boleano que indica se a ultima mensagem enviada naquela conversa foi por uma automação

Example:

true

Excluir produto Buscar conversa por ID

⌘I

Primeiros Passos

API Reference

Buscar conversas

Authorizations

Query Parameters

Response