Integrações

← Painel

O que o JR OS conversa com o mundo. Nenhuma chave fica no código ou volta ao navegador. O Cofre criptografa as credenciais no servidor; as variáveis antigas do Netlify funcionam apenas como contingência.

🔐 Cofre de IntegraçõesJR OS 2026.402

Cadastre, substitua, teste, revogue e audite Asaas, WhatsApp, Microsoft, e-mail e destinatários pelo próprio site.

Abrir Cofre de Integrações
Arquivos e nuvens
OneDrive — projetos e documentosintegração disponível

Conecta uma conta Microsoft por OAuth, permite navegar pelas pastas e importar arquivos para a biblioteca privada do JR OS. Os tokens ficam criptografados no servidor.

MICROSOFT_CLIENT_IDno Cofre
MICROSOFT_CLIENT_SECRETno Cofre
MICROSOFT_TENANT_IDno Cofre
JR_MASTER_ENCRYPTION_KEYsomente no Netlify
A conexão é feita uma vez por usuário administrador. Depois, os arquivos podem ser pesquisados e importados sem compartilhar a senha Microsoft com o JR OS.
Conectar e abrir OneDrive
iCloud Drive — importação assistidapronto para uso

No iPhone, iPad ou Mac, o seletor nativo permite escolher arquivos e pastas do iCloud Drive. A Apple não fornece a sites comuns acesso silencioso a todo o iCloud Drive, então a seleção continua sob controle do usuário.

Importar do iCloud Drive
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_VENCIMENTOnúmero de dias
ASAAS_WEBHOOK_TOKENobrigatória
ASAAS_BOLETO_CANCELAR_APOS_DIASopcional
ASAAS_JUROS_MENSAL_PERCENTUALopcional
ASAAS_MULTA_PERCENTUALopcional
ASAAS_LIBERAR_CARTAO_EMopcional
ASAAS_NOTIFICACOESopcional
JR_REGUA_COBRANCAopcional
No Asaas: Integrações → API → gerar chave. Use ASAAS_AMBIENTE=sandbox com chave iniciada em $aact_hmlg_ para homologação, e producao com chave iniciada em $aact_prod_ para cobranças reais. ASAAS_DIAS_VENCIMENTO deve ser apenas um número, como 3. ASAAS_LIBERAR_CARTAO_EM=confirmed considera o cartão quitado quando o pagamento é confirmado; use received para aguardar a disponibilização do saldo. ASAAS_NOTIFICACOES=ativas mantém a comunicação padrão do Asaas; use desativadas quando toda a régua for controlada somente pelo JR OS. JR_REGUA_COBRANCA=2,5,10,20 define os dias de atraso dos lembretes internos.
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 forte de 32 a 255 caracteres, sem espaços, 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: selecione todos os eventos de pagamento (PAYMENT_*). No mínimo: CREATED, UPDATED, AWAITING_RISK_ANALYSIS, APPROVED_BY_RISK_ANALYSIS, REPROVED_BY_RISK_ANALYSIS, AUTHORIZED, CONFIRMED, RECEIVED, CREDIT_CARD_CAPTURE_REFUSED, ANTICIPATED, OVERDUE, DELETED, RESTORED, REFUNDED, PARTIALLY_REFUNDED, REFUND_IN_PROGRESS, REFUND_DENIED, RECEIVED_IN_CASH_UNDONE, CHARGEBACK_REQUESTED, CHARGEBACK_DISPUTE, AWAITING_CHARGEBACK_REVERSAL, DUNNING_REQUESTED e DUNNING_RECEIVED.
  5. Salve e faça um pagamento de teste no sandbox.
Quando funcionar, a proposta muda sozinha entre pendente, parcial, confirmada, recebida, vencida, estornada ou em contestação. O histórico registra o valor bruto, líquido, parcelas e estornos. A obra só é liberada quando a regra de quitação configurada for atendida.
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.

GEMINI_API_KEYobrigatória
GOOGLE_GENERATIVE_AI_API_KEYalternativa
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 Central de MensagensAutomação unificadaConfigurar WhatsApp
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.