Tarefas do lead de empresa

Corresponde à aba Tarefas da tela Leads de empresas. Lista as atividades ligadas ao lead, como retornar uma ligação ou enviar uma proposta. Cada tarefa é a mesma tarefa da tela Tarefas, vinculada ao lead; veja Tarefas.

Endpoints

Método	Caminho	Descrição
GET	/crm/business-leads/{business_lead_uuid}/tasks	Lista as tarefas do lead
POST	/crm/business-leads/{business_lead_uuid}/tasks	Cria uma tarefa para o lead
GET	/crm/business-leads/{business_lead_uuid}/tasks/{id}	Consulta uma tarefa do lead
PUT	/crm/business-leads/{business_lead_uuid}/tasks/{id}	Altera uma tarefa do lead
DELETE	/crm/business-leads/{business_lead_uuid}/tasks/{id}	Remove uma tarefa do lead
PATCH	/crm/business-leads/{business_lead_uuid}/tasks/{id}/complete	Marca a tarefa como concluída
GET	/crm/business-leads/tasks/statuses	Lista as situações de tarefa (apoio)
GET	/crm/business-leads/tasks/priorities	Lista as prioridades de tarefa (apoio)

GET /crm/business-leads/{business_lead_uuid}/tasks

Lista as tarefas do lead.

Parâmetros de URL

Parâmetro	Descrição
search	Texto no assunto ou na descrição da tarefa
business_lead_id	Id do lead
status_id	Id da situação da tarefa
priority_id	Id da prioridade da tarefa
start_date	Data inicial do vencimento da tarefa (AAAA-MM-DD)
end_date	Data final do vencimento da tarefa (AAAA-MM-DD)
per_page, page	Paginação, conforme Convenções

Resposta (200): a lista de tarefas, com o assunto, o vencimento, o lembrete, a situação, a prioridade e os nomes de quem criou e de quem alterou.

POST /crm/business-leads/{business_lead_uuid}/tasks

Cria uma tarefa para o lead. Há duas formas:

• Nova tarefa: informe subject e os demais campos.
• Tarefa existente: informe task_uuid com o uuid de uma tarefa já cadastrada, para vinculá-la ao lead.

Corpo

Campo	Obrigatório	Tipo	Descrição
task_uuid	Não	uuid	Tarefa já cadastrada, a vincular ao lead
subject	Sim, se task_uuid não for informado	texto	Assunto da tarefa
priority_id	Não	inteiro	Prioridade da tarefa
status_id	Não	inteiro	Situação da tarefa
user_id	Não	inteiro	Responsável pela tarefa. Sem ele, a tarefa fica com o usuário que a criou
due_date	Não	data	Data de vencimento
reminder_datetime	Não	data e hora	Lembrete. Não pode ser posterior à data de vencimento
description	Não	texto	Descrição da tarefa

Exemplo

curl -X POST https://api.pedagogo.app/crm/business-leads/<uuid-do-lead>/tasks \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <token-de-sessao>" \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Enviar proposta",
    "due_date": "2026-11-20",
    "reminder_datetime": "2026-11-19 09:00:00"
  }'

Resposta (201): o vínculo da tarefa com o lead.

PUT /crm/business-leads/{business_lead_uuid}/tasks/{id}

Altera a tarefa e o vínculo com o lead. Envie apenas os campos que mudam.

Corpo

Campo	Obrigatório	Tipo	Descrição
subject	Não	texto	Assunto da tarefa
priority_id	Não	inteiro	Prioridade da tarefa
status_id	Não	inteiro	Situação da tarefa
user_id	Não	inteiro	Responsável pela tarefa
due_date	Não	data	Data de vencimento
reminder_datetime	Não	data e hora	Lembrete. Não pode ser posterior à data de vencimento
description	Não	texto	Descrição da tarefa

Resposta (200): o vínculo da tarefa com o lead, já com os dados atualizados.

Consultar e apagar

GET /crm/business-leads/{business_lead_uuid}/tasks/{id} traz o vínculo, com a tarefa e o lead. DELETE /crm/business-leads/{business_lead_uuid}/tasks/{id} remove o vínculo e a tarefa. Resposta (200).

PATCH /crm/business-leads/{business_lead_uuid}/tasks/{id}/complete

Marca a tarefa como concluída. Não há corpo. Resposta (200): a tarefa, com a situação Concluída.

GET /crm/business-leads/tasks/statuses

Lista as situações de tarefa, para os campos status_id. Aceita per_page e page. Resposta (200): a lista de situações.

GET /crm/business-leads/tasks/priorities

Lista as prioridades de tarefa, para o campo priority_id. Aceita per_page e page. Resposta (200): a lista de prioridades.