Atividades

Gerencie tarefas e atividades dentro do pipeline de vendas. Agende ligacoes, reunioes, emails e acompanhamentos com suporte a templates e sequencias automatizadas.

Base URL

Todos os endpoints usam o prefixo /api/v1/accounts/{account_id}/pipeline/activities

Listar Atividades

GET/api/v1/accounts/{account_id}/pipeline/activities

Lista atividades com filtros.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`pipeline_card_id`(query)	`integer`	Nao	Filtrar por card do pipeline
`type`(query)	`string`	Nao	call, email, meeting, task, note, demo, follow_up (filtra activity_type)
`status`(query)	`string`	Nao	Status: pending, in_progress, completed, cancelled
`priority`(query)	`string`	Nao	Filtrar por prioridade
`assigned_to_id`(query)	`integer`	Nao	Filtrar por responsavel
`overdue`(query)	`boolean`	Nao	true para apenas atividades atrasadas
`upcoming`(query)	`boolean`	Nao	true para apenas atividades futuras
`page`(query)	`integer`	Nao	Pagina (padrao 1)
`per_page`(query)	`integer`	Nao	Itens por pagina (padrao 25)

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/pipeline/activities?status=pending" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de atividades (chave activities)

json

{
  "activities": [
    {
      "id": 1,
      "pipeline_card_id": 5,
      "activity_type": "call",
      "status": "pending",
      "priority": "medium",
      "title": "Ligacao de follow-up",
      "description": "Confirmar interesse na proposta",
      "scheduled_at": "2026-02-20T14:00:00Z",
      "due_at": null,
      "duration": 30,
      "is_overdue": false,
      "created_by": { "id": 3, "name": "Maria Santos" },
      "assigned_to": { "id": 3, "name": "Maria Santos" },
      "created_at": "2026-02-15T10:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 15,
    "per_page": 25
  }
}

POST/api/v1/accounts/{account_id}/pipeline/activities

Cria uma nova atividade.

Parametro obrigatorio na URL

O pipeline_card_id deve ser passado como query param na URL, nao no corpo da requisicao. Todos os campos do corpo devem estar dentro do wrapper activity.

Query Params

Nome	Tipo	Obrigatorio	Descricao
`pipeline_card_id`(query)	`integer`	Sim	ID do card do pipeline ao qual a atividade pertence

Body (dentro de activity)

Nome	Tipo	Obrigatorio	Descricao
`title`	`string`	Sim	Titulo da atividade
`activity_type`	`string`	Sim	call, email, meeting, task, note, demo, follow_up
`scheduled_at`	`string`	Nao	Data/hora agendada (ISO 8601)
`duration`	`integer`	Nao	Duracao em minutos
`description`	`string`	Nao	Descricao detalhada
`assigned_to_id`	`integer`	Nao	ID do agente responsavel
`contact_id`	`integer`	Nao	ID do contato associado

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/pipeline/activities?pipeline_card_id=5" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "activity": {
      "activity_type": "meeting",
      "title": "Reuniao de apresentacao",
      "scheduled_at": "2026-02-20T14:00:00Z",
      "duration": 60
    }
  }'

Nota

Para GET, PATCH e DELETE em uma atividade especifica, inclua ?pipeline_card_id=XXX na URL.

GET/api/v1/accounts/{account_id}/pipeline/activities/{id}?pipeline_card_id={card_id}

Retorna detalhes de uma atividade.

PATCH/api/v1/accounts/{account_id}/pipeline/activities/{id}?pipeline_card_id={card_id}

Atualiza uma atividade. Wrap fields inside activity object.

DELETE/api/v1/accounts/{account_id}/pipeline/activities/{id}?pipeline_card_id={card_id}

Remove uma atividade.

Acoes da Atividade

POST/api/v1/accounts/{account_id}/pipeline/activities/{id}/start?pipeline_card_id={card_id}

Inicia uma atividade agendada.

POST/api/v1/accounts/{account_id}/pipeline/activities/{id}/complete?pipeline_card_id={card_id}

Marca a atividade como concluida.

POST/api/v1/accounts/{account_id}/pipeline/activities/{id}/cancel?pipeline_card_id={card_id}

Cancela a atividade.

POST/api/v1/accounts/{account_id}/pipeline/activities/{id}/reschedule?pipeline_card_id={card_id}

Reagenda a atividade.

Body

Nome	Tipo	Obrigatorio	Descricao
`scheduled_at`	`string`	Sim	Nova data/hora (ISO 8601)

GET/api/v1/accounts/{account_id}/pipeline/activities/search

Busca atividades por texto.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`q`(query)	`string`	Sim	Texto de busca

GET/api/v1/accounts/{account_id}/pipeline/activities/analytics

Metricas de atividades (conclusao, atrasos, por tipo).

200Analytics de atividades (objeto top-level, sem envelope data)

json

{
  "total": 150,
  "by_type": { "call": 45, "meeting": 30, "email": 50, "task": 25 },
  "by_status": { "pending": 40, "in_progress": 12, "completed": 98, "cancelled": 0 },
  "by_priority": { "low": 10, "medium": 100, "high": 40 },
  "completion_rate": 65.3,
  "overdue_count": 12,
  "upcoming_count": 20,
  "average_duration": 18,
  "by_outcome": { "successful": 80, "no_answer": 18 }
}

Operacoes em Lote

POST/api/v1/accounts/{account_id}/pipeline/activities/bulk_create

Cria a mesma atividade em multiplos cards de uma vez (max 100 cards).

Query + Body

Nome	Tipo	Obrigatorio	Descricao
`pipeline_card_id`	`integer`	Sim	Query param obrigatorio. Mesmo usando pipeline_card_ids no body, e preciso passar um pipeline_card_id na query — sem ele a rota retorna 404.
`pipeline_card_ids`	`array`	Sim	Body: IDs dos cards onde a atividade sera criada (max 100, escopados a conta). Mais que 100 retorna 400.
`activity`	`object`	Sim	Body: objeto com os campos da atividade (activity_type, title, scheduled_at, etc.) — os mesmos de Criar Atividade.

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/pipeline/activities/bulk_create?pipeline_card_id=5" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline_card_ids": [5, 9, 12],
    "activity": { "activity_type": "call", "title": "Ligacao de prospeccao" }
  }'

POST/api/v1/accounts/{account_id}/pipeline/activities/create_from_template?pipeline_card_id={card_id}

Cria uma atividade a partir de um template, vinculada ao card informado na query.

Query Params

Nome	Tipo	Obrigatorio	Descricao
`pipeline_card_id`(query)	`integer`	Sim	ID do card ao qual a atividade sera vinculada

Body

Nome	Tipo	Obrigatorio	Descricao
`template_id`	`integer`	Sim	ID do template de atividade
`activity`	`object`	Nao	Campos da atividade que sobrescrevem os defaults do template

Sequencias de Atividades

GET/api/v1/accounts/{account_id}/pipeline/activity_sequences

Lista sequencias de atividades.

POST/api/v1/accounts/{account_id}/pipeline/activity_sequences

Cria uma nova sequencia.

Body (pipeline_activity_sequence)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome da sequencia
`description`	`string`	Nao	Descricao
`steps`	`array`	Sim	Array de passos (nao pode estar vazio). Cada passo: {day, activity_type, title, duration}

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/pipeline/activity_sequences" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pipeline_activity_sequence": {
      "name": "Cadencia de Vendas",
      "steps": [
        { "day": 1, "activity_type": "call", "title": "Ligacao inicial", "duration": 15 },
        { "day": 3, "activity_type": "email", "title": "Email de follow-up", "duration": 5 }
      ]
    }
  }'

GET/api/v1/accounts/{account_id}/pipeline/activity_sequences/{id}

Detalhes de uma sequencia.

PATCH/api/v1/accounts/{account_id}/pipeline/activity_sequences/{id}

Atualiza uma sequencia.

DELETE/api/v1/accounts/{account_id}/pipeline/activity_sequences/{id}

Remove uma sequencia.

Templates de Atividade

GET/api/v1/accounts/{account_id}/pipeline/activity_templates

Lista templates de atividade.

POST/api/v1/accounts/{account_id}/pipeline/activity_templates

Cria um novo template.

Body (pipeline_activity_template)

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome do template
`activity_type`	`string`	Sim	call, email, meeting, task, note, demo, follow_up
`category`	`string`	Nao	Categoria do template
`default_content`	`string`	Nao	Conteudo padrao da atividade (nao existe campo "title" no template)
`description`	`string`	Nao	Descricao padrao
`default_duration`	`integer`	Nao	Duracao padrao em minutos

Formato de resposta

A resposta e retornada dentro de um objeto data: {"data": {"id": 1, ...}}

DELETE/api/v1/accounts/{account_id}/pipeline/activity_templates/{id}

Remove um template.