Chatbot Contábil

Este endpoint fornece acesso a um assistente de IA treinado para responder a perguntas sobre contabilidade e sobre os dados da sua organização.

Objeto Mensagem do Chatbot

Atributo	Tipo	Descrição
role	string	O autor da mensagem (user ou model).
content	string	O conteúdo da mensagem.

---

Enviar uma Mensagem

Envia uma pergunta ou comando para o chatbot e recebe uma resposta contextual.

POST/api/chatbot

Corpo da Requisição

{
  "message": "Qual foi o meu faturamento total no último trimestre?",
  "conversationHistory": [
    {
      "role": "user",
      "content": "Olá, Finvy!"
    },
    {
      "role": "model",
      "content": "Olá! Como posso ajudar você hoje?"
    }
  ]
}

Atributo	Tipo	Descrição
message	string	Obrigatório. A nova mensagem do usuário.
conversationHistory	array	Opcional. Um array de objetos de Mensagem do Chatbot representando o histórico da conversa para manter o contexto.

Resposta

Retorna a resposta do modelo de IA.

{
  "role": "model",
  "content": "Analisando seus dados... Seu faturamento total no último trimestre foi de R$ 150.000,00, com a maior parte vindo da venda de serviços de consultoria."
}

Códigos de Status HTTP

• 200 OK: Mensagem processada e resposta do chatbot retornada com sucesso.
• 400 Bad Request: Dados da requisição inválidos.
• 401 Unauthorized: Autenticação necessária ou credenciais inválidas.
• 500 Internal Server Error: Erro interno do servidor ao processar a mensagem.