# 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. Organizar · Escrita · Depende 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 - 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. | | `titulo` | texto | Sim | Aceita: de 1 a 160 caracteres | | `tipo` | texto | Não | O tipo: o id ou o nome (atividades_configuracao). Sem ele, o tipo padrão da conta. Aceita: de 1 a 80 caracteres | | `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 | | `descricao` | texto | Não | Aceita: até 5000 caracteres | | `prioridade` | texto | Não | Aceita: alta, normal, baixa | | `inicioEm` | texto | Não | O início: data e hora com fuso, como 2026-11-10T15:00:00-03:00. Aceita: de 10 a 40 caracteres | | `venceEm` | texto | Não | 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. Aceita: de 10 a 40 caracteres | | `diaInteiro` | sim ou não | Não | O prazo vale o dia inteiro (23h59 no fuso da conta). | | `lembrete` | texto | Não | Lembrete 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 | | `lembrarEm` | texto | Não | O 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 | | `acaoNaConversa` | texto | Não | O que o lembrete faz na conversa ligada: avisar a pessoa, criar uma nota ou reabrir. Aceita: avisar, nota, reabrir | | `responsavel` | vários formatos | Não | 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` | número inteiro | Não | O setor (time). Sem ele, o time da conversa. Aceita: a partir de 1 | | `contato` | número inteiro | Não | O contato. Aceita: a partir de 1 | | `contatoNome` | texto | Não | O nome do contato, como aparece na lista. Aceita: de 1 a 160 caracteres | | `conversa` | número inteiro | Não | O número da conversa (exige a caixa). Aceita: a partir de 1 | | `caixa` | número inteiro | Não | A caixa de entrada da conversa. Aceita: a partir de 1 | | `negocio` | texto | Não | O 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}$ | | `mensagem` | número inteiro | Não | A mensagem da conversa de onde a atividade saiu. Aceita: a partir de 1 | | `trecho` | texto | Não | O trecho dessa mensagem, como o cliente escreveu (exige a mensagem). Aceita: de 1 a 500 caracteres | | `checklist` | lista de objeto | Não | Aceita: até 30 itens | | `checklist[].id` | texto | Não | O 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[].texto` | texto | Sim | Aceita: de 1 a 200 caracteres | | `checklist[].feito` | sim ou não | Não | | | `resultado` | texto | Não | 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. ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "atividades_criar", "arguments": { "conta": "nome-da-sua-conta", "titulo": "texto" } } } ``` **Esquema de entrada** ```json { "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** ```json { "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" ] } ```