activities.list

Histórico global de atividades. Atividades de todos os contatos que quem pede enxerga, do mais recente para o mais antigo, com os filtros do Histórico de atividades do Clickmax. Cada item traz eventName (nome do evento no original, como crm.tag.lead.apply.v1), name, category (Checkout, Email, Chat, Tag, Lead, Opportunity, PageView, Cart, PaymentFailedOrExpired ou MemberArea), leadId/leadName, opportunityId, leadTaskId, messageId, quem fez (actorType, actorId, actorName) e meta com os detalhes do tipo (tag, etapa, valor, produto, texto da mensagem…).

Filtros (E entre eles; dentro de cada lista, qualquer valor): eventName, startDate/endDate (AAAA-MM-DD ou ISO; dia sem hora vale o dia inteiro em UTC), tagIds, pipelineIds, flowIds, productIds. offerIds, pageIds, funnelIds e messageIds existem no original e não têm fonte aqui: com algum valor a lista vem vazia. leadId limita a um contato (precisa estar visível, senão not_found).

Paginação como o original: page (de 1) e perPage (50, até 100); meta.countItens é o total ("N atividades no total") e meta.countPages as páginas. Só as 5 000 mais recentes de cada fonte ficam ao alcance de páginas fundas: acima disso data vem vazio e countPages para antes; filtre por período para chegar mais longe. timezone é o fuso da conta, para agrupar por dia. Ao vivo: repita page: 1, perPage: 50 a cada 5 segundos.

Fontes: mensagens e notas internas, atendimentos, compras e cancelamentos, oportunidades (criada, ganha, perdida), tarefas, consentimentos de envio, execuções de automação (flows e Instagram) e eventos de domínio (etiquetas, campos, etapas, vendas de integrações, carrinho, assinatura, comentários do Instagram). Tipos do original sem fonte aqui (e-mail, campanha, voz, Telegram, páginas, área de membros do original, leitura da conversa por IA…) aparecem em activities.filter_options com hasSource: false.

Endpoint: POST https://app.atomiks.com.br/api/v1/activities.list (corpo JSON)
Quem pode chamar: membro da conta
Escopo da chave: crm:read
Grava dados: não
Pela chave de API: sim
Ferramenta MCP: activities_list
Ficha em JSON: https://app.atomiks.com.br/api/v1/openapi.json (operationId activities.list)

Entrada

Campo	Tipo	Obrigatório
`eventName`	string[]	não
`startDate`	string	não
`endDate`	string	não
`offerIds`	string[]	não
`pageIds`	string[]	não
`funnelIds`	string[]	não
`productIds`	string (uuid)[]	não
`tagIds`	string (uuid)[]	não
`messageIds`	string[]	não
`pipelineIds`	string (uuid)[]	não
`flowIds`	string (uuid)[]	não
`leadId`	string (uuid)	não
`page`	integer	não
`perPage`	integer	não

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "eventName": {
      "maxItems": 400,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "startDate": {
      "type": "string",
      "maxLength": 40
    },
    "endDate": {
      "type": "string",
      "maxLength": 40
    },
    "offerIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "pageIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "funnelIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "productIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    },
    "tagIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    },
    "messageIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "pipelineIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    },
    "flowIds": {
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "format": "uuid",
        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
      }
    },
    "leadId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "perPage": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  }
}

Exemplo

curl -X POST https://app.atomiks.com.br/api/v1/activities.list \
  -H "Authorization: Bearer $ATOMIKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"startDate":"2026-10-01","eventName":["crm.tag.lead.apply.v1"],"page":1,"perPage":50}'

CLI:

node cli/atomiks.mjs activities.list --json '{"startDate":"2026-10-01","eventName":["crm.tag.lead.apply.v1"],"page":1,"perPage":50}'

MCP: ferramenta activities_list com a mesma entrada.

Saída

Sucesso: {"data": ...} com o formato abaixo.

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "eventName": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "createdAt": {
            "type": "string"
          },
          "leadId": {
            "type": [
              "string",
              "null"
            ]
          },
          "leadName": {
            "type": [
              "string",
              "null"
            ]
          },
          "opportunityId": {
            "type": [
              "string",
              "null"
            ]
          },
          "leadTaskId": {
            "type": [
              "string",
              "null"
            ]
          },
          "objectRecordId": {
            "type": [
              "string",
              "null"
            ]
          },
          "messageId": {
            "type": [
              "string",
              "null"
            ]
          },
          "aggregateId": {
            "type": [
              "string",
              "null"
            ]
          },
          "actorType": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "user",
                  "flow",
                  "automation",
                  "ai",
                  "api",
                  "system"
                ]
              },
              {
                "type": "null"
              }
            ]
          },
          "actorId": {
            "type": [
              "string",
              "null"
            ]
          },
          "actorName": {
            "type": [
              "string",
              "null"
            ]
          },
          "meta": {
            "anyOf": [
              {
                "type": "object",
                "propertyNames": {
                  "type": "string"
                },
                "additionalProperties": {}
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "eventName",
          "name",
          "category",
          "createdAt",
          "leadId",
          "leadName",
          "opportunityId",
          "leadTaskId",
          "objectRecordId",
          "messageId",
          "aggregateId",
          "actorType",
          "actorId",
          "actorName",
          "meta"
        ],
        "additionalProperties": false
      }
    },
    "meta": {
      "type": "object",
      "properties": {
        "page": {
          "type": "number"
        },
        "perPage": {
          "type": "number"
        },
        "countItens": {
          "type": "number"
        },
        "countPages": {
          "type": "number"
        }
      },
      "required": [
        "page",
        "perPage",
        "countItens",
        "countPages"
      ],
      "additionalProperties": false
    },
    "timezone": {
      "type": "string"
    }
  },
  "required": [
    "data",
    "meta",
    "timezone"
  ],
  "additionalProperties": false
}

Erros

{"error": {"code", "message", "requestId"}}. Códigos: invalid_input (400), unauthorized (401), forbidden / account_pending / scope_missing (403), not_found (404), limit_reached (409), internal (500).