Conectores

Um conector liga seus apps a um serviço que você já tem: Stripe para pagamentos, OpenAI para IA, Resend para e-mail, Google Sheets para dados. Você o conecta uma vez, na sua conta, e todo app que você escolher pode usá-lo. São mais de sessenta, de pagamentos e lojas a CRMs, agendas, IA e ferramentas de design.

Todo app já tem um banco de dados, login e e-mails próprios, sem nada para conectar: isso é o Cloud, no alto da lista, embutido e sempre ativo. Os conectores servem para o que vem de fora.

Onde encontrá-los

• No painel ou no editor: +, depois Connectors, para escolher quais conectores este app pode usar.
• Manage connectors, no pé dessa janela, abre a própria página Connectors, onde os serviços são conectados. Ela se abre sobre o editor ou o painel, então você não perde o seu lugar.
• Na página Connectors, a lista da esquerda filtra os blocos por All, Enabled, Custom connectors, MCP servers e por tipo de serviço, e a caixa de busca encontra um serviço pelo nome.
• O + no canto superior direito adiciona um que não está na lista: descreva você mesmo com Custom connector, ou peça a nós com Request a connector. MCP server também está lá, para a IA que cria seus apps e não para os apps.
• No editor, Manage, depois Integrations, mostra o que este app pode usar. Veja Integrações.

Conecte um serviço

Abra o serviço na página Connectors. Cada um diz o que o seu app pode fazer com ele, o que ele não faz quando isso importa, e quanto os seus apps o usaram nos últimos 30 dias. Há duas formas de entrar: entrar no serviço com a sua conta ou colar as chaves que ele te dá. A página Connectors mostra a que cada serviço tem. Alguns têm as duas, e então a página diz Sign in with the service, or add your own keys instead.

Com um botão. Stripe, Notion, Google Sheets, Airtable, Slack, Discord, Calendly, Google Calendar, Microsoft 365, HubSpot, Pipedrive, Zoho CRM, Zoho Books, Salesforce, Linear, Asana, Atlassian (Jira e Confluence), Figma, Canva, GitHub e GitLab se conectam entrando no serviço e voltando. Você nunca vê nem copia uma chave. No Stripe, o botão é Set up Stripe: veja Lojas online. O Salesforce pede ao seu administrador que instale o pacote do Setherion uma vez antes do primeiro login.

Com chaves. Para os outros, cole as chaves que o serviço fornece em Credentials. Where do I find these? abre a página certa do serviço, e cada caixa tem uma dica dizendo exatamente qual chave ela quer. Test connection as testa antes de você contar com elas, e Connect as guarda. Depois de conectado, Update as muda e Remove as tira. Se Connect estiver cinza, uma caixa está vazia ou você ainda não marcou a linha que diz que você entendeu os termos do serviço: Take me there leva você até ela.

Um serviço conectado mostra um ponto verde no bloco dele, e Enabled ao lado do nome. Antes da primeira conexão, cada serviço diz em palavras simples o que isso significa para você, e você marca que entendeu. Um selo resume: Billed by o serviço quando ele cobra você pelo uso, por exemplo Billed by Supabase, Handles real money para pagamentos e lojas, e No usage charges para os demais.

O próximo passo depois de Connect

Logo depois de você conectar um serviço na página dele, um cartão diz Stripe is connected. Next: use it in this app, ou build an app with it quando você veio do painel. O botão dele, Use in this app ou Build an app with it, escreve para você uma solicitação inicial no chat, como “Use Stripe in this app: online payments, subscriptions and invoices”, e coloca o serviço na lista do app. A solicitação espera na caixa de mensagem. Nada é criado nem gasto até você clicar em Send. Você pode fechar o cartão, e ele não volta nas visitas seguintes. Serviços de design e código, como Figma e GitHub, não têm esse cartão, porque são lidos enquanto um app é criado e não usados por ele.

O que um serviço não faz

Quando um serviço tem um limite óbvio, a página dele avisa em uma nota cinza, com um botão para os conectores que fazem o trabalho no lugar dele. O PayPal é o exemplo: cada botão compra um item, não há carrinho, e o seu app não é avisado quando alguém paga, então a nota aponta para Stripe e Paddle.

Escolha quais apps o usam

Conectar um serviço não o coloca em todos os apps. No app, abra +, depois Connectors, marque os que este app pode usar e clique em Done. Tudo o que você deixar de fora fica fora do código do app e das chaves dele. Um serviço que ainda não está conectado tem Connect ao lado, que leva você à página dele.

Depois peça o que ele deve fazer, no chat:

Você não precisa marcar antes. Se a sua mensagem citar um serviço que o app ainda não alcança, uma barra acima da caixa de mensagem diz This needs Stripe e oferece três respostas: Use it here quando ele já está conectado, Connect com uma chave ou o próprio login do serviço, ali mesmo, ou Build without it. Sem ele, o app diz que o recurso não está configurado em vez de fingir que funciona.

Permissões

Alguns serviços listam o que seus apps podem fazer com eles, em Permissions na página deles depois de conectados. Cada linha tem dois botões: o visto permite, o círculo riscado desliga.

• Uma mudança é salva assim que você a clica e vale na hora para todo app que usa a conexão, inclusive os publicados.
• Um app que tenta algo desligado recebe um erro que diz isso, e onde ligar de novo. Os novos apps são avisados e deixam isso de fora.
• O serviço continua concedendo à sua chave ou ao seu login tudo o que lhes foi dado. Estes limites são do Setherion, mantidos por cima.
• Remover a conexão liga tudo de volta.

O Shopify é diferente. Seus apps o chamam direto da página com o Storefront token dele, que é público por natureza, então os limites dele são definidos no Shopify: abra Sales channels, depois Headless, depois a sua vitrine, clique em Manage ao lado de Storefront API e edite Permissions. A página dele no Setherion mostra os mesmos passos.

Com o Supabase, o Firebase, o Google Maps e o Cloudinary é igual: seus apps os chamam direto da página, então os limites deles são definidos em cada serviço, e a página deles no Setherion diz onde.

Qualquer outro serviço diz em uma frase, em Permissions, tudo o que seus apps podem fazer com ele, por exemplo só enviar e-mails ou só ler seus produtos. Canva, Figma, GitHub e GitLab dizem que seus apps nunca os usam: só você, no editor.

HubSpot

O HubSpot traz o seu CRM para dentro dos seus apps: contatos, empresas, negócios e tickets. Há duas formas de conectá-lo.

• Connect with HubSpot: entre no HubSpot, escolha a conta e aprove. Até o HubSpot terminar de revisar o Setherion, a tela dele avisa que o app ainda não foi verificado e pede que você digite “I accept the risk” para continuar.
• Uma chave de serviço: no HubSpot, abra Development, depois Keys, depois Service keys, e crie uma com leitura e escrita para contatos, empresas, negócios e tickets. Cole-a em Credentials. As chaves do HubSpot começam com pat-.

Quem pode usá-lo em um app publicado:

• Qualquer pessoa: um formulário do seu site pode adicionar um contato ou um ticket.
• Só a sua equipe: ler o CRM e mudar qualquer coisa nele. Marque as contas que são da sua equipe em Manage, depois Cloud, depois Users. Veja Trabalhar em equipe.

Para impedir que os apps mudem seus negócios enquanto ainda os leem, desligue Change para negócios em Permissões.

Seu próprio Supabase

O Supabase é opcional: todo app já tem um backend. Conecte-o quando quiser os dados de um app em um projeto Supabase seu.

• Credentials: o endereço do projeto e a anon key dele, que é pública por natureza. A service role key é opcional.
• Connect Supabase account, em Creating the tables, permite que o Setherion crie as tabelas de que um app precisa no seu projeto, a partir de Manage, depois Cloud, cada vez que você clicar no botão lá. Você entra no Supabase e aprova. A permissão fica nos servidores do Setherion e nunca é entregue aos apps que você publica. Sem ela, as tabelas continuam lá para você copiar e colar no Supabase por conta própria.

Para mover um app que já tem dados para o seu próprio Supabase, veja Ajustes avançados.

O que existe

Todos os conectores, agrupados do jeito das páginas que os descrevem. Cada página tem uma lista suspensa por serviço: para que ele serve, que chaves ele pede e onde encontrá-las, o que pedir, os interruptores dele e os limites dele.

Para um serviço que não está na lista, descreva você mesmo: veja Conectores personalizados. Para uma única chave de que um app precisa, Chaves e segredos é suficiente.

Quem pode usar uma conexão

Suas chaves nunca chegam a um visitante, então um app publicado chama um serviço pelo Setherion, e o Setherion decide o que é permitido.

• Só os caminhos de que um app precisa. Um app que envia e-mail pode enviar, e não alcança a sua conta, as suas chaves nem os seus domínios. A vitrine de uma loja lê produtos e não consegue ler pedidos nem clientes.
• O remetente e a conta são fixos. Um app não pode escolher um endereço de remetente, número de telefone, agenda ou lista diferente do que você salvou.
• Sua equipe e seus visitantes são diferentes. Em um CRM, o formulário de um visitante pode deixar um lead, e só a sua equipe pode ler ou mudar qualquer coisa. Marque a sua equipe em Manage, depois Cloud, depois Users. A página de cada conector diz quais ações dele são públicas.
• Tudo o que chega a uma pessoa ou custa dinheiro tem limite de frequência. E-mails, SMS, mensagens de chat, cadastros e pagamentos são limitados a cerca de dez chamadas por hora para cada visitante. A leitura dos seus próprios dados permite muito mais. Um app que passa do limite é avisado para tentar de novo mais tarde.
• Um fusível diário e um mensal. Um app pode fazer alguns milhares de chamadas a serviços por dia, e as chamadas de um app publicado usam créditos de integração.

Em um espaço de trabalho de equipe

No Business, Settings, depois Connector settings, dá a um espaço de trabalho de equipe duas escolhas. Só o dono ou um admin pode mudar a primeira, e só o dono pode emprestar.

• Quais conectores os apps do espaço de trabalho podem usar. Um conector que não é permitido fica fora de toda criação, não coloca nenhuma chave em um app publicado, e toda chamada a ele é recusada.
• Emprestar as conexões do dono. O app de um membro pode usar a conexão do dono com um serviço que o membro não conectou por conta própria. As chaves ficam nos nossos servidores e nunca chegam ao membro. O provedor cobra essas chamadas da conta do dono, e elas contam nos créditos de integração de quem criou.

Pagamentos, lojas e bancos de dados nunca são emprestados: as contas, os repasses e os dados deles pertencem a quem os conectou. Veja Espaços de trabalho.

Conectores personalizados e servidores MCP

Para um serviço que não está na lista, descreva você mesmo: veja Conectores personalizados. Para dar à IA que cria seus apps as próprias ferramentas, adicione um servidor em Seus servidores MCP.

Bom saber

• Uma chamada que um app publicado faz a um serviço conectado usa um crédito de integração. Veja Créditos. Você vê o que cada app gastou em Consumo.
• Serviços que cobram você pelo uso, como Resend, Twilio ou OpenAI, cobram da sua própria conta, pelos preços deles. Defina um limite de gasto lá: o Setherion limita a velocidade com que um app pode chamar, o que impede abusos, mas não consegue limitar o que você gasta.
• Quando um app chama um serviço que não está conectado, Manage, depois Integrations, avisa, com Add the key.
• Desconectar um serviço impede na hora que todo app que o usa o alcance.