Selo de estado:
Preview(teto atual do produto) · Curso ACD-210 — Conectores e conexões · Aula 2 de 8 · Atualizado em 2026-10-05.
Objetivo#
Ao final desta aula você vai ler o estado de um conector no catálogo e saber o que ele autoriza — e nunca mais prometer a um cliente uma integração que o produto não entrega hoje.
Vídeo#
Identificador no manifesto: acd-210-02-catalogo-de-conectores-por-estado · duração-alvo 7 min · tela do produto: /conexoes.
Roteiro de gravação (5 capítulos):
| # | Minutagem-alvo | Capítulo | Tela do produto |
|---|---|---|---|
| 1 | 0:00–0:50 | Abertura: título + selo. A regra da aula: o catálogo é consultado, não decorado — e por quê. | /conexoes/nova |
| 2 | 0:50–2:30 | Os três selos do cartão — Disponível · Acesso limitado · Planejado — lidos direto do catálogo de sistemas, com a legenda que o produto exibe em cada um. | /conexoes/nova |
| 3 | 2:30–4:10 | Onde mais se lê o mesmo estado: a página pública do conector, a tabela do catálogo nas docs e a ficha do conector. Quatro superfícies, um estado. | /conexoes/nova |
| 4 | 4:10–5:40 | Por que quase tudo está em Acesso limitado: o gate humano (credencial real + 30 dias de medição, um conector por vez). Não é desleixo, é recusa de prometer o que não foi medido. | /conexoes/nova |
| 5 | 5:40–7:00 | O que fazer quando o conector é Planejado: ler a condição, que já traz a alternativa. O "faça você mesmo". | /conexoes |
Conteúdo#
Esta aula não é uma lista de conectores
O catálogo cresce — em uma única onda ele passou de 21 para 110 conectores. Decorar nomes envelhece em uma semana. O que não muda é isto: existem três estados, eles são derivados do catálogo do produto (nunca redigitados) e aparecem no mesmo lugar em toda superfície. Aprenda a consultar e a interpretar; a lista é trabalho do produto, não da sua memória.
Ordem de grandeza (medida em 2026-10-05)
| Estado | Quantos, na data da medição | Leitura |
|---|---|---|
| Disponível | 9 | o que dá para prometer hoje, sem condição |
| Acesso limitado | 98 | existe, sob a condição escrita na página do conector |
| Planejado | 3 | não existe ainda; a condição traz a alternativa |
| Total | 110, em 14 categorias | — |
Esses números são da data acima, e é assim que se cita: "na última medição, 9 de 110". Quem precisa do número de hoje abre o catálogo de conectores e conta na tabela — ela é gerada do catálogo do produto. Nunca cite de cabeça.
Dois eixos, não um
Estado público (Disponível · Acesso limitado · Planejado) responde "dá para eu usar isto hoje?". Maturidade (GA-candidato · Preview · Roadmap) responde "quanta prova existe por trás?". Confundir os dois foi o que, no passado, fez a mesma integração aparecer como "Disponível" numa tela e "Preview" em outra. Os dois valem, ao mesmo tempo, e o catálogo de conectores publica ambos.
Os três selos: o que cada um autoriza e o que proíbe
| Selo | Legenda que o produto exibe | Autoriza | Proíbe |
|---|---|---|---|
| Disponível | "Pode ser usado hoje, no fluxo normal do produto." | Cadastrar e extrair no fluxo normal, com a credencial da origem | Prometer SLA, certificação de nuvem ou disponibilidade geral — o teto do produto é GA-candidato e nada é anunciado como GA |
| Acesso limitado | "Existe, sob a condição descrita nesta página." | Exatamente o que a condição concreta do cartão e da ficha diz — e, hoje, todos aceitam cadastro e teste | Tratar como pronto para uso crítico, e prometer prazo de liberação |
| Planejado | "Ainda não entregue — não dá para usar hoje." | Nada. Ler a condição, que diz qual é o caminho alternativo | Qualquer botão de "usar hoje"; o cartão não vira link em nenhuma superfície |
O selo é derivado do catálogo do produto, nunca redigitado: disponivel → Disponível, estrutura → Acesso limitado, roadmap → Planejado.
Onde se lê o estado: quatro superfícies, um estado
| Superfície | Onde | O que ela mostra |
|---|---|---|
| Catálogo de sistemas do console | /conexoes/nova — "De qual sistema vêm os seus dados?" | O selo no cartão, a legenda do estado e, no rodapé, a porta de entrada ou a recusa |
| Página pública do conector | /conectores/<conector> | O mesmo selo, com a condição concreta por extenso — é o link que se manda para o cliente |
| Tabela do catálogo nas docs | data/conectores | Uma linha por conector: categoria, estado público, maturidade, configuração (aceita/recusada) e forma de auth |
| Ficha do conector | fichas por conector → a ficha | Campos do formulário, credenciais, limites, erros comuns — e o estado repetido no topo |
Se duas superfícies discordarem, não escolha a mais otimista: isso é defeito, e tem teste de coerência cobrindo. Abra chamado.
Por que quase tudo está em "Acesso limitado"
Esta é a pergunta que mais aparece em proposta, e a resposta é curta:
Nenhum conector novo entra como "Disponível". A promoção depende de um gate humano: credencial real do fornecedor e 30 dias de medição com tráfego de verdade — reconciliação, rotação de credencial e quotas —, um conector por vez.
Ou seja: "Acesso limitado" não é fila de espera nem desleixo. É o produto recusando-se a anunciar o que ninguém mediu. O julgamento de prontidão é explícito no código: a parte verificável roda em teste, e os itens que dependem de gente ficam sempre pendentes até alguém medir. Por construção, nenhum teste promove conector a "Disponível".
Consequência prática, e é a que fecha negócio sem criar dívida: a maioria dos conectores aceita cadastro e teste hoje, com a condição de que a extração ao vivo é liberada conector a conector, depois de validada com uma credencial real da sua conta. O caminho é falar com o suporte para entrar na liberação — e isso é exatamente o que a condição do cartão diz.
Os nove "Disponível" de hoje
Três famílias, e vale conhecê-las porque são a resposta a "o que posso prometer sem condição?":
| Família | Conectores | Porta de entrada |
|---|---|---|
| Arquivos | csv · json · parquet | "Enviar arquivo — não pede senha" |
| Bancos de dados | postgresql · mysql · sqlserver · oracle · bigquery | "Cadastrar acesso (passo a passo)" |
| Planilhas e colaboração | google_sheets | "Conectar ao criar o pipeline" |
A porta de entrada vem da categoria, não do estado
O estado diz se dá; a categoria diz por onde. São 14 categorias e apenas três portas — mais a recusa:
| Famílias de categoria | Porta | O que o cartão diz |
|---|---|---|
| Arquivos | fluxo de arquivos (upload para a área de recebimento) | "Enviar arquivo — não pede senha" |
| Bancos de dados | assistente de conexão (endereço, usuário, senha) | "Cadastrar acesso (passo a passo)" |
| Todas as outras — SaaS, warehouses, object storage, arquivos remotos, APIs genéricas | fluxo de fontes do pipeline | "Conectar ao criar o pipeline" |
| Planejado ou configuração recusada | nenhuma | "Cadastro indisponível: <motivo>" ou "Este sistema ainda não pode ser cadastrado por conta própria." |
O assistente de conexão é a porta dos bancos de dados — ele pede endereço, usuário e senha, e nada disso se aplica a uma API. É por isso que a aula 3 usa um PostgreSQL e a aula 7 usa o fluxo de fontes.
"Configuração": a coluna que decide a conversa
Além do selo, a tabela do catálogo tem a coluna Configuração — aceita ou recusada. Ela responde algo que o selo não responde: a tela deixa salvar?
Na medição de 2026-10-05, os únicos conectores com a configuração recusada são os três Planejados. Todo o resto — os 9 Disponíveis e os 98 em Acesso limitado — aceita cadastro e teste. Mas leia a coluna, não decore a frase: ela existe justamente porque a recusa pode voltar a aparecer dentro de Acesso limitado, e já apareceu antes (conectores de ERP e CRM ficaram recusados enquanto a rotação do refresh token não era persistida ponta a ponta).
Quando o conector que você precisa está "Planejado"
A condição de um Planejado nunca é só "não dá": ela diz por que não dá e qual é o caminho de hoje. Os três de 2026-10-05:
| Conector | Por que não dá | Caminho de hoje |
|---|---|---|
| PagBank | A API consulta uma cobrança de cada vez, pelo número dela, e não devolve a lista de cobranças da conta | Exportar o extrato e enviá-lo para a área de recebimento do seu ambiente |
| Senior | O acesso à API depende de credencial de parceiro homologado | Exportações agendadas para a área de recebimento |
| TOTVS Protheus | A API REST varia por versão e customização do ambiente | Exportações agendadas (CSV/JSON) para a área de recebimento |
O padrão é o mesmo nos três: o dado entra por arquivo. Repare que a saída existe, está escrita na própria condição e é verificável — é isso que se leva para o cliente, não "está no roadmap".
Dois nomes de marca que mudaram de empresa
O rótulo do catálogo é o nome que o cliente reconhece, e nem sempre é o nome atual da empresa. Dois casos registrados:
| No catálogo | Hoje a empresa é | O que isso muda para você |
|---|---|---|
| Moskit CRM | Ollow — o domínio antigo redireciona e a empresa se descreve como "ex-Moskit" | Continue achando o conector por "Moskit"; mas não escreva numa proposta que Moskit é uma empresa independente |
| Movidesk | Zenvia | Idem: o conector segue como "Movidesk" no catálogo; a empresa é a Zenvia |
Os dois seguem no catálogo com o nome antigo de propósito — é por ele que o cliente procura. A ficha de cada um ainda aponta para a API da marca antiga, e isso está registrado como pendência de verificação com credencial real. Lição geral: o nome do cartão é um rótulo de busca, não um atestado de que a empresa existe com aquele nome.
No workspace Aurora Varejo
Maria recebe o pedido: "integre o Bling, o nosso bucket S3 e o Protheus". Em /conexoes/nova ela digita "bling": cartão com selo Acesso limitado, rodapé "Conectar ao criar o pipeline" — é clicável, e a condição diz que a extração ao vivo é liberada conector a conector depois de validada com credencial real. Procura "S3": mesmo selo, mesma condição. Procura "Protheus": selo Planejado, cartão sem link, e o motivo na tela já traz a alternativa (exportação agendada para a área de recebimento).
Ela volta ao cliente com três frases verificáveis, não com uma promessa: Bling e S3 existem e entram pela liberação com o suporte; o Protheus entra por arquivo exportado; e o que dá para ligar hoje, sem condição, é o PostgreSQL do ERP antigo, que está em Disponível. Nenhuma das três frases precisou do número total de conectores.
Erros comuns
| Sintoma | O que conferir | Próxima ação |
|---|---|---|
| "Decorei que eram 21 e o cliente achou 80" | A data da sua informação | O catálogo é consultado na hora; cite sempre com a data da medição |
| "Prometi o conector e não consigo salvar" | Coluna Configuração no catálogo | recusada → leia o motivo na tela; aceita → o problema é credencial ou rede, não estado |
| "O cartão não é clicável" | A frase no rodapé do cartão | O motivo está escrito ali; não há caminho alternativo por conta própria |
| "Não encontrei o sistema na busca" | Estado do conector na ficha | Um conector Planejado não aparece como opção de cadastro, de propósito |
"Vi Preview na ficha e Disponível no cartão" | Os dois eixos | É coerente: estado público ≠ maturidade |
| "Achei que Acesso limitado = bloqueado" | A condição escrita no cartão | Hoje quase todos aceitam cadastro; a condição diz o que falta |
| "O conector tem um ícone nosso, então é menos pronto" | O selo, só o selo | O desenho do cartão não é selo de estado: 78 conectores exibem a marca do fornecedor e 32 usam marca nossa (monograma ou desenho geométrico), e isso não diz nada sobre disponibilidade |
O que esta aula não ensina a fazer
Ela não ensina a contornar uma recusa — não existe contorno por conta própria, e isso é deliberado: em produção nada finge sucesso. O runner R/Python de scripts, que às vezes aparece nessa conversa, não é conector: é execução de script isolada, e continua indisponível. E ela não decora a lista: as fichas por conector ficam em fichas por conector.
Faça você mesmo#
No workspace de treino Aurora Varejo, como dono. Nenhum cadastro é criado neste exercício.
- Abra
/conexoese use Nova conexão para chegar ao catálogo de sistemas (/conexoes/nova). Leia o contador de sistemas no topo e anote o número com a data de hoje — é assim que esse número se cita. - Escolha três conectores em estados diferentes (um Disponível, um Acesso limitado, um Planejado) e, para cada um, copie: o selo, a legenda e a frase do rodapé do cartão.
- Para o Planejado, copie a frase inteira do motivo e sublinhe a alternativa que ela oferece. Se não houver alternativa escrita, é defeito — abra chamado.
- Abra o catálogo de conectores e, para os mesmos três, confira na tabela: estado público, maturidade e configuração. Os três campos têm de bater com o que você leu na tela.
- Abra a ficha de um dos três e confirme que o estado no topo dela é o mesmo. Três superfícies, um estado.
- Conte na tabela quantos estão em cada estado e compare com a medição desta aula (9 · 98 · 3, em 2026-10-05). Se divergir, o certo é a tabela — e o número que você vai usar é o dela.
- Escreva três linhas de resposta a um pedido fictício do cliente: um conector que dá para usar hoje sem condição, um em Acesso limitado (com a condição transcrita) e um Planejado (com a alternativa). Nenhuma das três pode conter um número total de conectores.
Você terminou quando suas três linhas estão escritas só com frases transcritas da tela ou da tabela, você sabe dizer onde leria o estado de um conector que ainda não existia quando esta aula foi escrita, e consegue explicar, em uma frase, por que quase tudo está em Acesso limitado.
Checagem rápida#
Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.
Documentação relacionada#
- data/conectores
- data/conectores/fichas
- suporte/status-e-limitacoes — o que é
Roadmapno produto todo
Capacidades ensinadas#
C04.1 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".