Referência Técnica — Pipeline Pipedrive → BigQuery (dlt)¶
Atualizado: 2026-07-10 · por: sessão manual · rev: 1 IDs, nomes de credenciais (NUNCA segredos), endpoints, schemas, snippets, dados de teste.
IDs¶
| Recurso | ID | Status | Notas |
|---|---|---|---|
| Projeto GCP | pipedrive-data-468012 |
Criado | Nome de exibição "pipedrive data"; conta Google rafael@bepex.com.br |
| Billing account GCP | 013BA3-01A246-A1437C |
Vinculado ao projeto | "My Billing Account 1" — pessoal do Rafael, ele está ciente/topou |
| Organização GitHub | bepex-sys |
Ativa | Org própria do Rafael — isolada da bepex-sistema (org compartilhada com outros devs, hospeda o app principal da Bepex) |
| Repositório GitHub | bepex-sys/bepex-data-pipelines |
Criado, privado | Só tem commit inicial do README (autor "bepexsys") — nenhum código do pipeline ainda |
| Dataset BigQuery | (a definir, ex. pipedrive_raw) |
Não criado | Fase 2 do plano.md |
| Service account GCP | (a criar) | Não criada | Precisa BigQuery Data Editor + BigQuery Job User |
Credenciais (nomes — nunca o segredo)¶
| Nome no sistema | ID/handle | Uso |
|---|---|---|
| Pipedrive api_token pessoal | extraído em https://bepex.pipedrive.com/settings/api |
Autenticação da fonte dlt pipedrive — nunca extrair/digitar via automação; o Rafael fornece o valor diretamente |
| Credencial n8n "Pipedrive account" | CHj11AO6T3756SqM (dono agente@bepex.com.br) |
Não é o mesmo que o api_token acima — é uma credencial interna do n8n, não utilizável fora dele. Mencionado aqui só pra não confundir numa busca futura. |
| GitHub Secret (sugerido) | PIPEDRIVE_API_TOKEN |
Nome sugerido pro secret do repo — confirmar ao criar |
| GitHub Secret (sugerido) | GCP_SA_KEY_BASE64 |
Nome sugerido pro secret do repo — JSON da service account em base64 |
Política de organização GitHub encontrada (bloqueio ativo)¶
https://github.com/organizations/bepex-sys/settings/personal-access-tokens
| Seção | Valor encontrado (2026-07-09) | Ação pendente |
|---|---|---|
| "Allow access via fine-grained personal access tokens" | Allow (padrão) — ok | — |
| "Require approval of fine-grained personal access tokens" | Require administrator approval | Rafael autorizou trocar pra "Do not require administrator approval". Tentativas de fazer isso via browser automation (Cowork) não persistiram — confirmar estado atual antes de assumir que ainda está bloqueado. |
| "Set maximum lifetimes for personal access tokens" | Must expire, máximo 366 dias | Não existe opção de "sem expiração" pra recursos de org — mesmo que o Rafael prefira token sem validade, o teto do org é 366 dias. |
Endpoints / Webhooks¶
(nenhum ainda — projeto não chegou na fase de pipeline/Actions)
Schemas / Field keys¶
(nenhum ainda)
Snippets¶
(nenhum ainda — nenhum código do pipeline foi escrito)
Dados de teste¶
(nenhum ainda)