Bolt.new: Integre Stripe, SendGrid e APIs Externas

Um app real precisa de mais do que UI — precisa de pagamentos, e-mails, notificações e integração com o ecossistema de ferramentas que seu negócio usa. O Bolt.new facilita essas integrações porque você tem acesso ao Node.js completo no backend.

Integrando Stripe para Pagamentos

Configuração inicial

Integre o Stripe ao projeto:
- Instale o pacote stripe
- Adicione STRIPE_SECRET_KEY no .env (backend) e VITE_STRIPE_PUBLIC_KEY no .env (frontend)
- Crie endpoint POST /api/create-checkout-session que:
  - Recebe priceId no body
  - Cria uma Checkout Session no Stripe
  - Retorna a URL de checkout
- No frontend, botão "Assinar" que chama o endpoint e redireciona para a URL do Stripe

Webhook do Stripe

Para confirmar pagamentos no servidor:

Adicione endpoint POST /api/stripe-webhook que:
- Usa stripe.webhooks.constructEvent() para validar a assinatura
- Quando evento é checkout.session.completed:
  - Atualiza status do usuário no banco para "premium"
- Configure STRIPE_WEBHOOK_SECRET no .env

No Stripe Dashboard: vá em Developers → Webhooks → Add endpoint → URL do seu app + /api/stripe-webhook

Integrando SendGrid para E-mails

Integre o SendGrid para e-mails transacionais:
- Instale @sendgrid/mail
- Adicione SENDGRID_API_KEY no .env
- Crie função sendWelcomeEmail(to: string, name: string) que:
  - Envia e-mail de boas-vindas com o template de HTML
  - From: noreply@seudominio.com
- Chame a função quando um novo usuário se cadastrar

Integrando com Slack

Notificações internas para sua equipe:

Adicione notificação Slack quando um novo usuário se cadastrar:
- Instale @slack/web-api
- Adicione SLACK_BOT_TOKEN e SLACK_CHANNEL_ID no .env
- Crie função notifyNewUser(email: string) que posta mensagem no canal
- Chame após cadastro bem-sucedido no backend

Google OAuth (Login com Google)

Implemente login com Google usando OAuth 2.0:
- Instale passport e passport-google-oauth20
- Configure GOOGLE_CLIENT_ID e GOOGLE_CLIENT_SECRET no .env
- Crie rotas GET /auth/google e GET /auth/google/callback
- Após login bem-sucedido, crie sessão com express-session
- Botão "Entrar com Google" no frontend

OpenAI API no backend

Para features de IA sem expor a chave no frontend:

Integre a OpenAI API no backend:
- Instale openai
- Adicione OPENAI_API_KEY no .env
- Crie endpoint POST /api/generate que:
  - Recebe prompt do body
  - Chama GPT-4o com streaming
  - Retorna a resposta via Server-Sent Events
- No frontend, exiba a resposta conforme chega (streaming)

Boas práticas de segurança para integrações

1. Nunca exponha chaves secretas no frontend — VITE_ prefixado vai para o bundle
2. Valide webhooks — sempre use as assinaturas (Stripe webhook secret, etc.)
3. Rate limiting — proteja endpoints de abuso com express-rate-limit
4. Logs de auditoria — registre ações críticas (pagamentos, mudanças de plano)

Instale express-rate-limit e configure:
- 10 requests por minuto no endpoint /api/generate
- 5 requests por hora no endpoint /api/create-checkout-session

Com essas integrações, seu app Bolt tem tudo que um produto SaaS real precisa.