Conectar BI (Power BI/Tableau) e Zapier/Make

Gere uma API key sua e conecte ferramentas de BI e de automação aos seus dados do CRM, sem nenhuma conta externa nossa.

Você pode ligar ferramentas de BI (Power BI, Tableau, Looker) e de automação (Zapier, Make, n8n) diretamente à sua base do CRM. Não é preciso nenhuma conta externa nossa: você gera uma API key dentro do próprio CRM e a conecta à ferramenta. Tudo é somente leitura e restrito aos dados do seu tenant.

Pré-requisitos

• Uma conta na ferramenta de BI (Power BI, Tableau, Looker Studio) ou de automação (Zapier, Make, n8n) que consiga consumir uma API REST/JSON com um cabeçalho de autenticação.
• No Sellio, ser administrador para gerar a API key em Configurações → API.

1) Gere uma API key

1. Abra Configurações → API.
2. Crie uma nova API key e copie o valor (ele começa com sk_ e só aparece uma vez; trate como uma senha).
3. Nas ferramentas, envie essa chave no cabeçalho: Authorization: Bearer sk_...

2) Endpoints de dados (as "tabelas")

• GET /api/v1/objects: lista os objetos disponíveis (as tabelas que o BI pode ler).
• GET /api/v1/data/{objeto}: os registros do objeto já achatados em linhas, com colunas estáveis: id, created_at, updated_at, owner_id e uma coluna por campo (o api_name do campo).

Paginação: use ?page=1&pageSize=100 (ou ?limit= e ?offset=). O pageSize máximo é 200. A resposta traz object, columns (nome e tipo de cada coluna), page, pageSize, total e rows.

3) Power BI / Tableau / Looker

1. No Power BI: Obter Dados → Web; no Tableau: Conector Web/JSON; no Looker Studio: conector JSON/URL.
2. Aponte para a URL de dados, por exemplo https://SEU-CRM/api/v1/data/opportunity
3. Adicione o cabeçalho Authorization com o valor Bearer sk_... (sua API key).
4. As colunas vêm estáveis e tipadas: mapeie uma vez e o relatório continua funcionando conforme novos registros entram.

4) Zapier / Make / n8n

• Gatilho por polling ("New/Updated record"): consulte GET /api/v1/data/{objeto}?updated_since=<ISO> (ou created_since=<ISO>) para receber só o que mudou ou nasceu desde a última verificação. Os mais recentes vêm primeiro.
• Gatilho instantâneo: em Configurações → Webhooks, crie um webhook de saída e aponte a URL para o "Catch Hook" do Zapier (ou o "Custom Webhook" do Make/n8n). A cada registro criado/atualizado, o CRM envia o evento assinado (HMAC) na hora.

Em Configurações → Integrações, o cartão "BI & Automação externa" reúne os links dos endpoints e o atalho para gerar a API key.

Como testar

1. Rápido: abra GET https://SEU-CRM/api/v1/objects com o cabeçalho Authorization: Bearer sk_... (num navegador com extensão, no Postman ou com curl) e confira a lista de objetos.
2. Leia dados: chame GET /api/v1/data/opportunity?pageSize=5 e confirme que vêm linhas com as colunas id, created_at, updated_at, owner_id e os campos.
3. No BI: monte a conexão apontando para a URL de dados e verifique se as colunas aparecem tipadas; no Zapier/Make, dispare o gatilho de teste e veja o registro chegar.

Solução de problemas

• 401 Unauthorized: a API key está ausente, errada ou não foi enviada como "Authorization: Bearer sk_...". Gere uma nova em Configurações → API (o valor só aparece uma vez) e reconfigure a ferramenta.
• 404 no endpoint: confira a URL. Objetos ficam em /api/v1/objects e dados em /api/v1/data/{api_name}. Use o api_name exato do objeto (não o rótulo em português).
• Vêm poucas linhas: há paginação. Use ?page=1&pageSize=200 (máximo 200) e itere as páginas; para incremental, use ?updated_since=<ISO>.
• Webhook instantâneo não dispara: confirme que o webhook de saída em Configurações → Webhooks aponta para o "Catch Hook" (Zapier) / "Custom Webhook" (Make/n8n) e está ativo. O CRM assina o envio (HMAC); valide o segredo se a ferramenta exigir.
• Só leio meus dados: correto, cada API key é isolada ao tenant dono; ela nunca enxerga dados de outra empresa.

Abrir este artigo dentro do sistema →