Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

Atualizar atividade

Altera os campos que vierem, na versão lida (atividades_obter): se alguém mudou a atividade antes, recusa e pede para ler de novo. null tira o que pode ficar vazio.

OrganizarEscritaDepende do plano: Atividades
Nome da ferramenta
atividades_atualizar

Exemplo de pedido

Você escreve para o agente, em linguagem natural:

Mude o título da atividade de ligar para a Padaria Exemplo para Ligar e confirmar a entrega.

Permissão

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
idtextoSimO 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}$
versaonúmero inteiroSimA versão da atividade que você leu.
Aceita: a partir de 1
titulotextoNãoAceita: de 1 a 160 caracteres
tipotextoNãoO tipo: o id ou o nome (atividades_configuracao). Sem ele, o tipo padrão da conta.
Aceita: de 1 a 80 caracteres
statustextoNãoO status: o id, o nome ou a categoria (a_fazer, em_andamento, concluida, cancelada = o primeiro status dela).
Aceita: de 1 a 80 caracteres
categoriatextoNãoA categoria do status.
Aceita: a_fazer, em_andamento, concluida, cancelada
descricaovários formatosNãoA descrição, até 5000 letras. null tira.
prioridadetextoNãoAceita: alta, normal, baixa
inicioEmvários formatosNãoO início: data e hora com fuso, como 2026-11-10T15:00:00-03:00. null tira.
venceEmvários formatosNãoO prazo: data e hora com fuso, como 2026-11-10T15:00:00-03:00; com diaInteiro, só a data (2026-11-10), no fuso da conta. null tira.
diaInteirosim ou nãoNãoO prazo vale o dia inteiro (23h59 no fuso da conta).
lembretetextoNãoLembrete relativo ao prazo. Sem lembrete: "nenhum". Sem dizer nada, vale o padrão do tipo.
Aceita: nenhum, na_hora, 10_min, 1_hora, vespera_9h
lembrarEmvários formatosNãoO instante do lembrete (data e hora com fuso, como 2026-11-10T15:00:00-03:00). null tira.
acaoNaConversatextoNãoO que o lembrete faz na conversa ligada: avisar a pessoa, criar uma nota ou reabrir.
Aceita: avisar, nota, reabrir
responsavelvários formatosNãoO responsável: o id da pessoa (um número) ou { "tipo": "pessoa" | "agente", "id": número }. Os agentes ligados vêm em atividades_configuracao. null tira.
setorvários formatosNãoO setor (time). null tira.
contatovários formatosNãoO contato. null tira.
contatoNomevários formatosNãoO nome do contato. null tira.
conversavários formatosNãoO número da conversa (exige a caixa). null tira.
caixavários formatosNãoA caixa de entrada da conversa. null tira.
negociovários formatosNãoO negócio do CRM (uuid). null tira.
mensagemvários formatosNãoA mensagem da conversa. null tira.
trechovários formatosNãoO trecho da mensagem, até 500 letras. null tira.
checklistvários formatosNãoO checklist inteiro (até 30 itens { id?, texto, feito? }); os itens que faltarem saem. null tira.
resultadovários formatosNãoO resultado, até 1000 letras. null tira.
pedidoIdtextoNãoOpcional: um uuid seu para este pedido. Repita o mesmo para não duplicar um envio quando a resposta não chegou.
Aceita: uuid

Limites

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_atualizar",
    "arguments": {
      "conta": "nome-da-sua-conta",
      "id": "texto",
      "versao": 123
    }
  }
}
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)."
    },
    "versao": {
      "type": "integer",
      "minimum": 1,
      "description": "A versão da atividade que você leu."
    },
    "titulo": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "tipo": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "O tipo: o id ou o nome (atividades_configuracao). Sem ele, o tipo padrão da conta."
    },
    "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."
    },
    "descricao": {
      "description": "A descrição, até 5000 letras. null tira."
    },
    "prioridade": {
      "type": "string",
      "enum": [
        "alta",
        "normal",
        "baixa"
      ]
    },
    "inicioEm": {
      "description": "O início: data e hora com fuso, como 2026-11-10T15:00:00-03:00. null tira."
    },
    "venceEm": {
      "description": "O prazo: data e hora com fuso, como 2026-11-10T15:00:00-03:00; com diaInteiro, só a data (2026-11-10), no fuso da conta. null tira."
    },
    "diaInteiro": {
      "type": "boolean",
      "description": "O prazo vale o dia inteiro (23h59 no fuso da conta)."
    },
    "lembrete": {
      "type": "string",
      "enum": [
        "nenhum",
        "na_hora",
        "10_min",
        "1_hora",
        "vespera_9h"
      ],
      "description": "Lembrete relativo ao prazo. Sem lembrete: \"nenhum\". Sem dizer nada, vale o padrão do tipo."
    },
    "lembrarEm": {
      "description": "O instante do lembrete (data e hora com fuso, como 2026-11-10T15:00:00-03:00). null tira."
    },
    "acaoNaConversa": {
      "type": "string",
      "enum": [
        "avisar",
        "nota",
        "reabrir"
      ],
      "description": "O que o lembrete faz na conversa ligada: avisar a pessoa, criar uma nota ou reabrir."
    },
    "responsavel": {
      "description": "O responsável: o id da pessoa (um número) ou { \"tipo\": \"pessoa\" | \"agente\", \"id\": número }. Os agentes ligados vêm em atividades_configuracao. null tira."
    },
    "setor": {
      "description": "O setor (time). null tira."
    },
    "contato": {
      "description": "O contato. null tira."
    },
    "contatoNome": {
      "description": "O nome do contato. null tira."
    },
    "conversa": {
      "description": "O número da conversa (exige a caixa). null tira."
    },
    "caixa": {
      "description": "A caixa de entrada da conversa. null tira."
    },
    "negocio": {
      "description": "O negócio do CRM (uuid). null tira."
    },
    "mensagem": {
      "description": "A mensagem da conversa. null tira."
    },
    "trecho": {
      "description": "O trecho da mensagem, até 500 letras. null tira."
    },
    "checklist": {
      "description": "O checklist inteiro (até 30 itens { id?, texto, feito? }); os itens que faltarem saem. null tira."
    },
    "resultado": {
      "description": "O resultado, até 1000 letras. null tira."
    },
    "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",
    "versao"
  ],
  "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."
    }
  },
  "required": [
    "atividade"
  ]
}