O que é o Datafala

O Datafala é uma API text-to-SQL: o seu sistema envia uma pergunta em linguagem natural ("quanto vendi do produto X nos últimos 6 meses?") e recebe de volta uma consulta SQL validada, com parâmetros nomeados, pronta para ser executada no seu banco.

1. A pessoa pergunta no seu sistema   "quanto vendi do produto X nos últimos 6 meses?"
2. Seu backend chama o Datafala       POST /v1/ask
3. O Datafala devolve                 { sql, params, explanation, request_id }
4. Seu backend executa no seu banco   com um usuário somente leitura
5. Seu sistema mostra o resultado     e, se quiser, envia 👍/👎 em POST /v1/feedback

O que a API faz

• Guarda, por cliente, a descrição do seu banco (o DDL das tabelas), descrições de tabelas e colunas, regras de negócio, glossário e exemplos de pergunta → SQL. Tudo isso é cadastrado no painel.
• Gera o SQL usando a LLM e a chave do próprio cliente (OpenAI, Anthropic, Gemini, DeepSeek e outros). O custo de tokens fica com você e nenhuma chave da plataforma é usada.
• Passa todo SQL gerado pelo SQL Guard, que só aceita um único SELECT sobre as tabelas e colunas cadastradas, com funções permitidas e LIMIT aplicado. Veja Segurança.
• Devolve sql, params, as tabelas usadas e uma explicação curta no idioma pedido.

O que a API não faz

A API nunca conecta ao seu banco

O Datafala não recebe credenciais do seu banco, não executa SQL e não vê os seus dados. Ele conhece apenas o schema que você cadastrou. Quem executa a consulta é o seu sistema, sempre com um usuário somente leitura.

• Não controla quais linhas cada usuário final pode ver. Se o seu sistema tem várias empresas ou permissões por linha, aplique esse filtro no banco (veja Executar o SQL).
• Não guarda os resultados das consultas, porque nunca os vê.

Bancos suportados

Banco	Valor de dialect	Drivers
PostgreSQL	postgres	psycopg 3, psycopg2, node-postgres (pg)
MySQL / MariaDB	mysql	PyMySQL, mysqlclient, mysql2
Firebird 2.5+	firebird	FDB (Python, Firebird 2.5+), firebird-driver (Python, Firebird 3+), FireDAC (Delphi), Jaybird (Java), node-firebird (Node.js)

O dialeto é escolhido ao cadastrar o DDL no painel e vale para todas as perguntas daquele schema. Para Firebird 2.5, use FDB; o firebird-driver requer Firebird 3 ou mais novo.

Endereços

O quê	URL
API	https://app.datafala.com.br
Painel do cliente	app.datafala.com.br/login
Contato	contato@tisolutio.com.br

Próximo passo: Primeiros passos.