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: Atividadesatividades_criarExemplo 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.
{
"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"
]
}