Documentação de Integração — Inforce → SQL

Visão Geral

Este documento descreve a proposta de integração entre o sistema Inforce e uma base de dados SQL, com o objetivo de:

• Centralizar dados em um banco estruturado
• Alimentar dashboards (Power BI, Streamlit, Dash)
• Automatizar relatórios (ex: PowerPoint)
• Garantir consistência e atualização contínua dos dados

---

Arquitetura do Fluxo

flowchart LR
    A[Inforce] --> B[Webhook / API]
    B --> C[Validação e Normalização]
    C --> D[Banco SQL]
    D --> E[Power BI]
    D --> F[Streamlit]
    D --> G[Dash / Plotly]
    D --> H[Geração PowerPoint]

Loading

---

Estratégia de Integração

A integração pode ocorrer de duas formas:

1. Pull (API)

• Consumo periódico via endpoints REST
• Ideal para sincronização contínua

2. Push (Webhook)

• Recebimento de eventos
• Ideal para atualizações imediatas

---

Objetivo da Base SQL

Recriar de forma automática a estrutura atualmente existente em Excel, porém com:

• maior confiabilidade
• atualização contínua
• enriquecimento de dados
• histórico completo de alterações

Exemplo de base já convertida:

• base_marco_2026.json

---

Endpoints Propostos

1️ Leads por data

POST {host}/api/v1/leads

Body

{
  "data": "2026-03-31",
  "page": 1,
  "page_size": 1000
}

Response

{
  "event": "lead_query",
  "date": "2026-03-31",
  "page": 1,
  "page_size": 1000,
  "lead": [...]
}

Descrição

Retorna todos os leads cadastrados na data informada, algo parecido com o:

---

2️ Conversões por data

POST {host}/api/v1/conversion

Body

{
  "data": "2026-03-31",
  "page": 1,
  "page_size": 1000
}

Response

{
  "event": "lead_conversion",
  "date": "2026-03-31",
  "page": 1,
  "page_size": 1000,
  "lead": [...],
  "conversions": [...],
}

Descrição

Retorna todas as conversões realizadas na data informada, meio que puxa todas as conversões que ocorreram no dia com as informações do lead:

---

3️ Conversões por lead

POST {host}/api/v1/leads/conversion

Body

{
  "id_atendimento": [123456, 1234567]
}

Descrição

Retorna o status de conversão de leads específicos.

---

4️ Produtos vinculados aos leads

POST {host}/api/v1/leads/products

Body

{
  "id_atendimento": [123456, 1234567]
}

Descrição

Retorna os produtos associados a cada lead.

---

5️ Histórico dos leads

POST {host}/api/v1/leads/history

Body

{
  "id_atendimento": [123456, 1234567]
}

Descrição

Retorna todo o histórico de alterações do lead:

• mudança de status
• alteração de responsável
• origem
• eventos

Tudo que fica no historico do lead

---

Sincronização de Dados

Problema identificado

• Leads podem mudar ao longo do tempo
• Status pode ser atualizado
• Responsáveis podem ser alterados

Solução proposta

• Uso de endpoints paginados
• Atualização incremental por data
• Uso opcional de webhooks para eventos críticos

---

Uso dos Dados

Após ingestão no banco SQL:

Dashboards

• Power BI
• Streamlit
• Dash / Plotly

Relatórios

• Geração automática de PPTX
• Relatórios executivos
• Análises avançadas