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, whatsappTipos 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 | ✘ | ✘ |