Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

Criar atividade

Cria uma atividade (tarefa, ligação, reunião, retorno, prazo) com prazo, lembrete, responsável, setor e vínculos com contato, conversa e negócio. Sem status, nasce no primeiro de "A fazer". Prazo ou lembrete já no passado não dispara aviso: a atividade nasce atrasada.

OrganizarEscritaDepende do plano: Atividades
Nome da ferramenta
atividades_criar

Exemplo de pedido

Você escreve para o agente, em linguagem natural:

Crie uma ligação para amanhã às 10h com a Maria Souza, ligada à conversa 1234.

Permissão

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
titulotextoSimAceita: 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
descricaotextoNãoAceita: até 5000 caracteres
prioridadetextoNãoAceita: alta, normal, baixa
inicioEmtextoNãoO início: data e hora com fuso, como 2026-11-10T15:00:00-03:00.
Aceita: de 10 a 40 caracteres
venceEmtextoNã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.
Aceita: de 10 a 40 caracteres
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
lembrarEmtextoNãoO instante do lembrete (data e hora com fuso, como 2026-11-10T15:00:00-03:00), no lugar do lembrete relativo.
Aceita: de 10 a 40 caracteres
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.
setornúmero inteiroNãoO setor (time). Sem ele, o time da conversa.
Aceita: a partir de 1
contatonúmero inteiroNãoO contato.
Aceita: a partir de 1
contatoNometextoNãoO nome do contato, como aparece na lista.
Aceita: de 1 a 160 caracteres
conversanúmero inteiroNãoO número da conversa (exige a caixa).
Aceita: a partir de 1
caixanúmero inteiroNãoA caixa de entrada da conversa.
Aceita: a partir de 1
negociotextoNãoO negócio do CRM.
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}$
mensagemnúmero inteiroNãoA mensagem da conversa de onde a atividade saiu.
Aceita: a partir de 1
trechotextoNãoO trecho dessa mensagem, como o cliente escreveu (exige a mensagem).
Aceita: de 1 a 500 caracteres
checklistlista de objetoNãoAceita: até 30 itens
checklist[].idtextoNãoO id de um item que já existe (para mantê-lo).
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}$
checklist[].textotextoSimAceita: de 1 a 200 caracteres
checklist[].feitosim ou nãoNão
resultadotextoNãoAceita: até 1000 caracteres
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_criar",
    "arguments": {
      "conta": "nome-da-sua-conta",
      "titulo": "texto"
    }
  }
}
Esquema de entrada
{
  "type": "object",
  "properties": {
    "conta": {
      "type": "string",
      "description": "A conta da Eloquus (slug). contas_listar mostra as suas."
    },
    "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": {
      "type": "string",
      "maxLength": 5000
    },
    "prioridade": {
      "type": "string",
      "enum": [
        "alta",
        "normal",
        "baixa"
      ]
    },
    "inicioEm": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "O início: data e hora com fuso, como 2026-11-10T15:00:00-03:00."
    },
    "venceEm": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "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."
    },
    "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": {
      "type": "string",
      "minLength": 10,
      "maxLength": 40,
      "description": "O instante do lembrete (data e hora com fuso, como 2026-11-10T15:00:00-03:00), no lugar do lembrete relativo."
    },
    "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."
    },
    "setor": {
      "type": "integer",
      "minimum": 1,
      "description": "O setor (time). Sem ele, o time da conversa."
    },
    "contato": {
      "type": "integer",
      "minimum": 1,
      "description": "O contato."
    },
    "contatoNome": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160,
      "description": "O nome do contato, como aparece na lista."
    },
    "conversa": {
      "type": "integer",
      "minimum": 1,
      "description": "O número da conversa (exige a caixa)."
    },
    "caixa": {
      "type": "integer",
      "minimum": 1,
      "description": "A caixa de entrada da conversa."
    },
    "negocio": {
      "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 negócio do CRM."
    },
    "mensagem": {
      "type": "integer",
      "minimum": 1,
      "description": "A mensagem da conversa de onde a atividade saiu."
    },
    "trecho": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "O trecho dessa mensagem, como o cliente escreveu (exige a mensagem)."
    },
    "checklist": {
      "type": "array",
      "maxItems": 30,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "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 de um item que já existe (para mantê-lo)."
          },
          "texto": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "feito": {
            "type": "boolean"
          }
        },
        "required": [
          "texto"
        ]
      }
    },
    "resultado": {
      "type": "string",
      "maxLength": 1000
    },
    "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",
    "titulo"
  ],
  "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."
    },
    "repetido": {
      "type": "boolean",
      "description": "O mesmo pedido já tinha criado esta atividade."
    }
  },
  "required": [
    "atividade",
    "repetido"
  ]
}