A criação de tarefas funciona como um agendamento de interações com o contato que possui uma negociação não fechada.
Cada tarefa precisará, obrigatoriamente, estar vinculada a uma negociação. Se os alertas automáticos estiverem devidamente configurados, um email será enviado ao usuário, avisando-o de suas tarefas do dia e atrasadas, caso haja.
As Tarefas possuem os seguintes tipos:
- Ligação (
call
) - Email (
email
) - Visita (
visit
) - Reunião (
meeting
) - Tarefa (
task
) - Almoço (
lunch
) - WhatsApp (
whatsapp
)
Atenção
- Não é possível excluir tarefas. Isso ocorrerá somente se for excluída a negociação à qual a tarefa está vinculada.
- O plano Free só pode criar tarefas do tipo "tarefa" (
type: "task"
).- Não é possível customizar ou criar novos tipos de tarefas.
Query params
Parâmetros utilizados para listar e obter tarefas.
Nome | Tipo | Descrição |
---|---|---|
token | String | Token do usuário |
task_id | String | ID da tarefa |
page | String | Número atual da página. Valor padrão é 1 |
limit | String | Limite de empresas que virão por listagem. Valor padrão é 20. Valor máximo é 200 |
deal_id | String | ID da negociação que a tarefa está vinculada |
done | String | Se a tarefa está concluída. Opções: true , false . |
type | String | Tipo de tarefa. Opções: call , email , meeting , task , lunch , visit , whatsapp . |
user_id | String | ID do usuário responsável pela tarefa |
date_start | String | Filtrar por data de início. Formato: YYYY-MM-DD . |
date_end | String | Filtrar por data final. Formato: YYYY-MM-DD . |
done_date_start | String | Filtrar por data de conclusão - início. Formato: YYYY-MM-DD . |
done_date_end | String | Filtrar por data de conclusão - final. Formato: YYYY-MM-DD . |
Body params
Parâmetros utilizados para criar e atualizar tarefas.
Nome | Tipo | Descrição | Obrigatório para criar | Obrigatório para atualizar | Observação |
---|---|---|---|---|---|
deal_id | String | ID da negociação cuja tarefa será vinculada | ✓ | ✓ | |
user_id | Array de String | ID do usuário responsável pela tarefa | ✓ | ✘ | |
subject | String | Assunto | ✓ | ✘ | |
type | String | Tipo da anotação | ✓ | ✘ | Tipos válidos para os planos Basic e Pro: call , email , meeting , task , lunch , visit , whatsapp Tipos válidos para o plano Free: task |
hour | String | Hora de conclusão | ✓ | ✘ | Formato: HH:mm . Exemplo: 14:30 . |
date | String | Data de conclusão | ✓ | ✘ | Formato: YYYY-MM-DD . |
notes | String | Notas para a tarefa | ✘ | ✘ |