Pular para o conteúdo
Eloquuspara desenvolvedoresEntrar

Etiquetar conversa

Acrescenta e tira etiquetas da conversa, sem mexer nas outras.

OrganizarEscrita
Nome da ferramenta
conversa_etiquetar

Exemplo de pedido

Você escreve para o agente, em linguagem natural:

Coloque a etiqueta orcamento na conversa 1234 e tire a etiqueta novo.

Permissão

Parâmetros

NomeTipoObrigatórioDescrição
contatextoSimA conta da Eloquus (slug). contas_listar mostra as suas.
conversaIdnúmero inteiroSimNúmero da conversa na Eloquus.
Aceita: a partir de 1
adicionarlista de textoNãoEtiquetas a acrescentar.
Aceita: até 20 itens
removerlista de textoNãoEtiquetas a tirar.
Aceita: até 20 itens
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": "conversa_etiquetar",
    "arguments": {
      "conta": "nome-da-sua-conta",
      "conversaId": 123
    }
  }
}
Esquema de entrada
{
  "type": "object",
  "properties": {
    "conta": {
      "type": "string",
      "description": "A conta da Eloquus (slug). contas_listar mostra as suas."
    },
    "conversaId": {
      "type": "integer",
      "minimum": 1,
      "description": "Número da conversa na Eloquus."
    },
    "adicionar": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 60
      },
      "description": "Etiquetas a acrescentar."
    },
    "remover": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 60
      },
      "description": "Etiquetas a tirar."
    },
    "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",
    "conversaId"
  ],
  "additionalProperties": false
}
Esquema da resposta
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "conversaId",
    "etiquetas",
    "mudou"
  ],
  "properties": {
    "conversaId": {
      "type": "integer"
    },
    "etiquetas": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "mudou": {
      "type": "boolean"
    }
  }
}