Ativando integrações

O app pode ter a tela de checkout, o campo de endereço ou o botão de enviar mensagem prontos e mesmo assim não funcionar: quem executa essas ações é o provedor, com a sua conta. Sem a credencial salva, a tela existe e a ação não acontece.

Onde fica

Aba Integrações, no editor. Ela tem duas subabas:

• Provedores: um card por serviço do catálogo, com busca por nome, os filtros Todas, Conectadas e Não conectadas, e as categorias (Pagamentos, Localização, Notificações, Produtividade e outras);
• APIs externas: para cadastrar uma API que não está no catálogo, com a chave guardada no servidor e usada por uma função de backend.

Dois assuntos parecidos moram em outras abas: o login social (Google, Apple, Microsoft e outros) fica em Autenticação, e o domínio de envio de e-mail fica em Domínios.

Plano

A aba Integrações abre em qualquer plano, e parte dos cards funciona em todos eles, inclusive no Free. Os outros pedem o plano Builder.

Nos planos Free e Starter, os cards que pedem o Builder aparecem esmaecidos, o aviso "Integrações são um recurso do plano Builder" fica no topo da aba, e clicar num desses cards leva aos planos. Os demais abrem e conectam normalmente.

A subaba APIs externas também é do plano Builder.

O servidor também confere o plano a cada uso para WhatsApp, Telegram, Shopify, Meta, Notion, Airtable, Mailchimp e Webhook (saída). Se a conta sair do Builder, essas integrações param de responder no app publicado, mesmo com a credencial ainda salva.

O e-mail com domínio próprio é um caso à parte: ele fica na aba Domínios e vale para qualquer plano pago. Veja E-mail com domínio próprio.

Como conectar um card

1. clique no card;
2. preencha os campos que ele pede (cada guia abaixo diz onde conseguir cada um);
3. clique em Salvar e ativar.

A plataforma salva e, nos provedores que permitem, testa a credencial na hora. Um campo secreto já salvo aparece depois com "· configurada" ao lado do nome. Desconectar, no rodapé do card, apaga a credencial da plataforma.

Para mudar uma chave de um card que já está conectado, digite só esse campo e salve. Um campo deixado em branco mantém o valor salvo, e o que a própria plataforma guarda (como o segredo do webhook da Stripe e o acesso autorizado das conexões por autorização) continua lá.

As chaves ficam cifradas no servidor e nunca voltam para a tela nem vão para o navegador de quem usa o app.

O que cada estado quer dizer

Nem todo card consegue testar a credencial ao salvar, e isso muda o que Conectado garante:

• testam de verdade, falando com o provedor: Stripe, Mercado Pago, Pagar.me, Hotmart e Google Maps;
• conferem só o formato do ID: Meta Pixel, Google Analytics, Google AdSense, Google Tag Manager, Microsoft Clarity, Hotjar e os chats (Baseportal Chat, Crisp, Tawk.to);
• só salvam, sem teste: SMS (Twilio), WhatsApp, Slack, Discord, Telegram, Notion, Airtable, Mailchimp, Webhook (saída), Shopify, Meta (Facebook/Instagram) e Google Workspace. Nesses, Conectado quer dizer "salvo", e a prova de que funciona é o primeiro envio real.

Quando o teste falha, a janela mostra "Salvo, mas a validação falhou" seguido do motivo que o provedor deu. O caminho é corrigir a credencial no provedor, não colar de novo o mesmo valor.

Chaves de teste e de produção

Vários provedores dão dois jogos de credenciais: um de teste, que não move dinheiro nem entrega de verdade, e um de produção.

• Stripe, Mercado Pago e Pagar.me não têm botão de ambiente no card: o que decide é qual chave você cola. Chave de teste, cobrança de teste. Troque pelas de produção antes de vender;
• Hotmart tem a opção "Usar o ambiente de testes (sandbox)". Deixe desmarcada com credencial de produção;
• WhatsApp e Twilio têm limites no modo de teste (números de destino permitidos, token que expira). Os guias de cada um explicam.

Créditos de integração

Configurar uma integração não gasta crédito nenhum. O que gasta são os créditos de integração, a moeda de rodar o app, quando o app publicado usa o provedor: cada SMS (inclusive o código de login por SMS), cada e-mail de automação ou aviso enviado pelo app, cada aviso no Slack ou no Discord, cada mensagem de WhatsApp ou Telegram e cada chamada a Shopify, Meta, Notion, Airtable, Mailchimp, Webhook (saída), Google Workspace e APIs externas.

O débito só acontece quando o provedor aceita. Uma chamada que falha não é cobrada. Com o saldo zerado, esses envios são recusados até o saldo voltar.

Pagamentos e Google Maps não consomem créditos de integração. O Maps usa a cota e o faturamento do seu projeto no Google.

O saldo e o uso do mês ficam no painel, em Cobrança. Veja Créditos.

O assistente avisa o que falta

Depois de um build, o chat mostra o card Para funcionar de verdade, com cada integração que o código do app usa e ainda não está ativa. Cada item tem dois botões:

• Ativar em Integrações: abre a aba Integrações direto no card daquela integração (no caso de pagamentos, na categoria Pagamentos, onde você escolhe o gateway);
• Como ativar: abre o guia daquele provedor, nesta documentação.

Quando uma integração fica ativa, o assistente confirma no chat.

O assistente também lê, a cada conversa, o estado das suas integrações: quais estão conectadas, quais estão salvas mas com problema e quais não foram conectadas. Pode perguntar no chat "o Stripe está ativo?". Ele vê o estado, nunca o valor das chaves.

Guias por provedor

Os cards de Analytics (Meta Pixel, Google Analytics, Google Tag Manager, Microsoft Clarity, Hotjar), de Chat e o de Consentimento de cookies pedem só um ID, e a descrição do próprio card diz onde encontrá-lo.

Problemas comuns

• O card está verde e nada acontece. Veja em qual grupo ele está na lista acima: nos cards que só salvam, Conectado não prova que a chave está certa. Faça um envio real e leia o erro;
• Salvei um gateway e o outro sumiu. Stripe, Mercado Pago e Pagar.me dividem o mesmo lugar: só um fica ativo por app, e salvar outro substitui o anterior. As chaves do gateway antigo não passam para o novo: preencha os campos do novo gateway;
• O card abre a tela de planos. A conta está no Free ou no Starter e esse card pede o Builder. Veja a tabela da seção Plano acima.