API de BI – Teia CRM

API para consulta de dados de leads do Teia CRM, voltada à integração com ferramentas de Business Intelligence (BI), como Power BI e Google Looker Studio.

Índice

• Endpoint
• Método HTTP
• Parâmetros da requisição
• Exemplo de requisição completa
• Como obter credenciais
• Exemplo de uso em Python
• Exemplo de uso em JavaScript
• Uso com ferramentas de BI
• Aviso de segurança

Endpoint

https://teiacrm.com.br/api/newapi/leads/{id_ambiente}

Método HTTP

• GET
• Também pode ser acessado diretamente no navegador.

Parâmetros da requisição

Parâmetro	Tipo	Obrigatório	Descrição
id_ambiente	string	sim	ID do ambiente (solicitar ao suporte)
createdFrom	date (YYYY-MM-DD)	não	Data inicial do filtro
createdTo	date (YYYY-MM-DD)	não	Data final do filtro
page	integer	não	Número da página para paginação
token	string	sim	Token de autenticação

Exemplo de requisição completa

https://teiacrm.com.br/api/newapi/leads/11234?createdFrom=2024-01-01&createdTo=2024-12-31&page=1&token=SEU_TOKEN

Como obter credenciais

Para obter id_ambiente e token, entre em contato com o suporte Teia CRM:

• E-mail: integracao@teiacrm.com ou suporte@teiacrm.com
• WhatsApp: (11) 93388-5568

Exemplo de uso em Python

import requests

url = "https://teiacrm.com.br/api/newapi/leads/11234"
params = {
    "createdFrom": "2024-01-01",
    "createdTo": "2024-12-31",
    "page": 1,
    "token": "SEU_TOKEN"
}

response = requests.get(url, params=params, timeout=30)
response.raise_for_status()

print(response.json())

Exemplo de uso em JavaScript

const endpoint = "https://teiacrm.com.br/api/newapi/leads/11234";
const params = new URLSearchParams({
  createdFrom: "2024-01-01",
  createdTo: "2024-12-31",
  page: "1",
  token: "SEU_TOKEN",
});

fetch(`${endpoint}?${params.toString()}`)
  .then((response) => {
    if (!response.ok) {
      throw new Error(`Erro na requisição: ${response.status}`);
    }
    return response.json();
  })
  .then((data) => console.log(data))
  .catch((error) => console.error(error));

Uso com ferramentas de BI

• Power BI: utilize o Web Connector para consumir o endpoint com os parâmetros desejados.
• Google Looker Studio: configure um conector de URL apontando para a requisição da API.

Aviso de segurança

token e id_ambiente são dados confidenciais.
Não versione credenciais no repositório — use variáveis de ambiente (ex.: .env) e mantenha esses arquivos no .gitignore.