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 e-mail 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) - E-mail (
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 Oportunidade à 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 exibir 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. Valores possíveis (true, false, null) |
| type | String | Tipo de tarefa. Valores possíveis: (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 válido: (hh:mm) Ex: 14:30 |
| date | String | Data de conclusão. | ✓ | ✘ | Formato válido (yyyy-mm-dd) |
| notes | String | Notas para a tarefa | ✘ | ✘ |