Integrações

O que o JR OS conversa com o mundo. Nenhuma chave fica no código — todas moram nas variáveis de ambiente do Netlify, e esta tela só pergunta ao servidor se elas estão lá.

Asaas — cobrançanão verificado

Gera PIX, boleto e cartão na hora em que o cliente aprova a proposta. O valor é recalculado no servidor, nunca vem do navegador.

ASAAS_API_KEYobrigatória
ASAAS_AMBIENTEopcional
ASAAS_DIAS_VENCIMENTOopcional
No Asaas: Integrações → API → gerar chave. Comece com ASAAS_AMBIENTE=sandbox para testar sem cobrar de verdade; depois troque para producao. ASAAS_DIAS_VENCIMENTO é opcional (padrão 3 dias).
Asaas — aviso de pagamento (webhook)configurar no Asaas

O contrário da chave: aqui é o Asaas avisando o JR OS quando o cliente paga, atrasa ou estorna — sozinho, na hora. Sem isto o sistema nunca fica sabendo que o dinheiro caiu, e alguém precisa conferir no painel do Asaas todo dia.

ASAAS_WEBHOOK_TOKENobrigatória
Você inventa uma senha qualquer (ex.: 30 caracteres aleatórios), põe nessa variável do Netlify e repete a mesma no painel do Asaas. É assim que o sistema sabe que quem está batendo na porta é mesmo o Asaas.
  1. No Asaas: Integrações → Webhooks → Adicionar.
  2. URL:
    https://SEUSITE/.netlify/functions/asaas-webhook
  3. Token de autenticação: a mesma senha de ASAAS_WEBHOOK_TOKEN.
  4. Eventos: PAYMENT_CONFIRMED, PAYMENT_RECEIVED, PAYMENT_OVERDUE, PAYMENT_REFUNDED, PAYMENT_DELETED, PAYMENT_RESTORED.
  5. Salve e faça um pagamento de teste no sandbox.
Quando funcionar, a proposta muda para paga sozinha, o histórico registra o valor líquido e a etapa da obra libera — sem ninguém digitar nada.
WhatsApp — envio e lembretenão verificado

Manda a proposta e cobra o retorno pelo WhatsApp oficial da Meta. Esta parte já estava construída no sistema.

WHATSAPP_ACCESS_TOKENobrigatória
WHATSAPP_PHONE_NUMBER_IDobrigatória
WHATSAPP_BUSINESS_ACCOUNT_IDopcional
WHATSAPP_VERIFY_TOKENopcional
WHATSAPP_APP_SECRETopcional
Na Meta: developers.facebook.com → seu app → WhatsApp → API Setup. Copie o token permanente e o Phone number ID.
O webhook do WhatsApp é como a Meta avisa que o cliente respondeu. Sem ele você manda mensagem e nunca vê a resposta dentro do JR OS. Esta parte já está construída: 
https://SEUSITE/.netlify/functions/whatsapp-webhook
Cole essa URL em WhatsApp → Configuration → Webhook, use WHATSAPP_VERIFY_TOKEN como token de verificação e assine o campo messages.
E-mail — proposta e avisosnão verificado

Envia a proposta, o aviso de aprovação e o lembrete de vencimento, com o papel timbrado da JR.

RESEND_API_KEYobrigatória
EMAIL_REMETENTEobrigatória
SENDGRID_API_KEYopcional
Mais simples: crie conta no Resend, verifique seu domínio e gere a API key. O remetente vai assim: JR Prestadora <orcamento@seudominio.com.br>. Se preferir SendGrid, use SENDGRID_API_KEY no lugar.
IA — leitura de projetonão verificado

Lê as pranchas e monta o orçamento. Já está configurada e funcionando.

ANTHROPIC_API_KEYobrigatória
Já em uso pelo sistema.
Banco — conciliaçãonão verificado

Puxa o extrato para casar recebimento com medição. Opcional, entra depois.

PLUGGY_CLIENT_IDopcional
PLUGGY_CLIENT_SECRETopcional
BELVO_SECRET_IDopcional
BELVO_SECRET_PASSWORDopcional
Só vale a pena depois que o Asaas estiver rodando.
Nota fiscalnão verificado

Emite a NFS-e da medição. Opcional.

FOCUSNFE_TOKENopcional
NFEIO_API_KEYopcional
Focus NFe ou NFE.io — depende de como sua contabilidade já emite hoje.
Assinatura eletrônicanão verificado

Contrato assinado direto do celular, sem imprimir. Opcional.

ESIGN_API_KEYopcional
Clicksign ou D4Sign atendem bem obra.
Comece por aqui
Lista do que falta, com passo a passoconfere sozinha

Cada pendência com o caminho exato no Netlify, no Asaas e na Meta — e um botão que verifica se já funcionou.

Abrir a lista
Acesso de cliente e arquiteto
Convite por link, sem senhapronto

Ninguém cria conta sozinho. Você convida, a pessoa clica e entra. Código de 8 caracteres, prazo de validade e revogação com um toque.

Gerenciar acessos
Automação
Mensagens automáticas de WhatsApppronto

33 eventos e 5 lotes: proposta enviada, lembrete, validade vencendo, aprovação, cobrança, medição, entrega e mais. Cada acontecimento manda a mensagem certa sozinho.

Abrir a automação
Como guardar uma chave com segurança
  1. Abra o painel do Netlify → seu site → Site configuration → Environment variables.
  2. Clique em Add a variable → Add a single variable.
  3. Em Key cole o nome exato que aparece nesta tela (ex.: ASAAS_API_KEY).
  4. Em Value cole a chave. Marque o escopo Functions.
  5. Salve e faça um novo deploy — variável só entra em vigor no deploy seguinte.
  6. Volte aqui e toque em Verificar.
Nunca me mande a chave pelo chat. Você cola direto no Netlify; eu só preciso saber se funcionou ou qual erro apareceu.