Etiquetar conversa
Acrescenta e tira etiquetas da conversa, sem mexer nas outras.
OrganizarEscritaconversa_etiquetarExemplo de pedido
Você escreve para o agente, em linguagem natural:
Coloque a etiqueta orcamento na conversa 1234 e tire a etiqueta novo.
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: Conversas.
- 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. |
conversaId | número inteiro | Sim | Número da conversa na Eloquus. Aceita: a partir de 1 |
adicionar | lista de texto | Não | Etiquetas a acrescentar. Aceita: até 20 itens |
remover | lista de texto | Não | Etiquetas a tirar. Aceita: até 20 itens |
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": "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"
}
}
}