Chat IA

Converse com a IA do NooviFlow sobre seus dados financeiros. O assistente tem acesso ao contexto completo de clientes, transacoes, KPIs e projecoes para fornecer insights e recomendacoes personalizadas.

GET/api/chat/messages

Retorna o historico de mensagens do chat com a IA.

Parametros

Nome	Tipo	Obrigatorio	Descricao
`page`(query)	`integer`	Nao	Pagina(default: `1`)
`limit`(query)	`integer`	Nao	Mensagens por pagina(default: `20`)

bash

curl -s "https://flow.seudominio.com/api/chat/messages?limit=50" \
  -H "Authorization: Bearer $TOKEN" | jq .

200Historico de mensagens

json

{
  "success": true,
  "data": {
    "messages": [
      {
        "id": "clx...",
        "role": "user",
        "content": "Qual foi minha receita no ultimo trimestre?",
        "createdAt": "2026-02-15T10:30:00Z"
      },
      {
        "id": "clx...",
        "role": "assistant",
        "content": "No ultimo trimestre (Nov/2025 - Jan/2026), sua receita total foi de R$ 96.500,00...",
        "createdAt": "2026-02-15T10:30:02Z"
      }
    ],
    "total": 42,
    "page": 1,
    "limit": 20
  }
}

POST/api/chat/messages

Envia uma mensagem para a IA e recebe resposta com contexto financeiro.

Body

Nome	Tipo	Obrigatorio	Descricao
`content`	`string`	Sim	Mensagem (1-4000 caracteres)

curl -X POST "https://flow.seudominio.com/api/chat/messages" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "content": "Quais clientes estao com pagamento atrasado?" }'

200Resposta da IA

json

{
  "success": true,
  "data": {
    "id": "clx...",
    "role": "assistant",
    "content": "Atualmente voce tem 3 clientes com pagamento atrasado:\n\n1. **Empresa ABC** - R$ 5.000 (vencido ha 15 dias)\n2. **Tech Corp** - R$ 3.200 (vencido ha 8 dias)\n3. **Startup XYZ** - R$ 1.800 (vencido ha 3 dias)\n\nTotal em atraso: R$ 10.000,00",
    "createdAt": "2026-02-15T14:22:00Z"
  }
}

DELETE/api/chat/messages

Limpa todo o historico de chat com a IA.

bash

curl -X DELETE "https://flow.seudominio.com/api/chat/messages" \
  -H "Authorization: Bearer $TOKEN"

DELETE/api/chat/messages/{id}

Remove uma mensagem especifica do historico.

bash

curl -X DELETE "https://flow.seudominio.com/api/chat/messages/clx123" \
  -H "Authorization: Bearer $TOKEN"