Mudar status da atividade
Leva a atividade para um status (pelo id, pelo nome ou pela categoria: concluida conclui, cancelada cancela, a_fazer reabre), com o resultado opcional. Vale sobre a versão atual; o status em que ela já está não muda nada.
OrganizarEscritaDepende do plano: Atividadesatividades_mudar_statusExemplo de pedido
Você escreve para o agente, em linguagem natural:
Marque como concluída a atividade de enviar a proposta, com o resultado proposta enviada.
Permissão
- Muda dados na Eloquus. Peça ao agente para mostrar o que vai fazer antes.
- Pede o escopo Organizar (
eloquus:organizar), que você marca na tela da Eloquus ao conectar. - Área da Eloquus: Atividades.
- Depende do plano: a conta precisa ter Atividades.
- Repetir a mesma chamada é seguro.
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
conta | texto | Sim | A conta da Eloquus (slug). contas_listar mostra as suas. |
id | texto | Sim | O id da atividade (de atividades_listar). Aceita: formato ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ |
status | texto | Não | O status: o id, o nome ou a categoria (a_fazer, em_andamento, concluida, cancelada = o primeiro status dela). Aceita: de 1 a 80 caracteres |
categoria | texto | Não | A categoria do status. Aceita: a_fazer, em_andamento, concluida, cancelada |
resultado | texto | Não | O resultado (por exemplo "contrato assinado"). Aceita: até 1000 caracteres |
pedidoId | texto | Não | Opcional: um uuid seu para este pedido. Repita o mesmo para não duplicar um envio quando a resposta não chegou. Aceita: uuid |
Limites
- 120 chamadas por minuto por conexão e 600 por minuto por conta, somando todos os agentes conectados.
Detalhes técnicos
Pedido JSON-RPC (tools/call)
Com só os campos obrigatórios e valores de exemplo.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "atividades_mudar_status",
"arguments": {
"conta": "nome-da-sua-conta",
"id": "texto"
}
}
}Esquema de entrada
{
"type": "object",
"properties": {
"conta": {
"type": "string",
"description": "A conta da Eloquus (slug). contas_listar mostra as suas."
},
"id": {
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
"description": "O id da atividade (de atividades_listar)."
},
"status": {
"type": "string",
"minLength": 1,
"maxLength": 80,
"description": "O status: o id, o nome ou a categoria (a_fazer, em_andamento, concluida, cancelada = o primeiro status dela)."
},
"categoria": {
"type": "string",
"enum": [
"a_fazer",
"em_andamento",
"concluida",
"cancelada"
],
"description": "A categoria do status."
},
"resultado": {
"type": "string",
"maxLength": 1000,
"description": "O resultado (por exemplo \"contrato assinado\")."
},
"pedidoId": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Opcional: um uuid seu para este pedido. Repita o mesmo para não duplicar um envio quando a resposta não chegou."
}
},
"required": [
"conta",
"id"
],
"additionalProperties": false
}Esquema da resposta
{
"type": "object",
"additionalProperties": false,
"properties": {
"atividade": {
"type": "object",
"additionalProperties": {},
"description": "A atividade: id, versao, titulo, tipoId, natureza, statusId, categoria, prazo (venceEm), lembrete, responsavel, setor, vínculos, checklist, resultado, origem, autor e datas. Conversa de outra caixa vem sem trecho, com conversaDeOutraCaixa: true."
},
"mudou": {
"type": "boolean",
"description": "false quando já estava nesse status."
}
},
"required": [
"atividade",
"mudou"
]
}