Como conectar o DocuSign
Passo a passo completo pra enviar contratos direto pela API do DocuSign, com a confirmação de assinatura chegando automaticamente — sem depender de ninguém técnico.
Antes de começar
- Leva de 10 a 20 minutos, mais o tempo do Go-Live (ver passo 5 abaixo).
- Você precisa de uma conta DocuSign — grátis pra testar, um plano pago pra uso real contínuo.
- Cada corretor/imobiliária cria a própria Integration Key no DocuSign — não é um app compartilhado do imob365.
- Diferente de Meta e Canva: o DocuSign exige uma etapa própria deles chamada Go-Live antes da conexão funcionar de verdade com documentos reais — mesmo sendo uma integração de conta única. Geralmente é rápido (minutos a poucos dias), mas é uma etapa real, não pule.
Crie a Integration Key no DocuSign
Faça login em admin.docusign.com → Integrações → Apps e Chaves → "Adicionar App e Chave de Integração" → dê o nome que quiser (ex.: "imob365 — Corretor João").
Configure a URI de redirecionamento
Na página da sua Integration Key recém-criada, adicione o valor abaixo no campo de URI de redirecionamento do OAuth:
https://portal.imob365.com.br/api/public/docusign/oauth/callbackGere a Secret Key
Ainda na mesma página, clique em "Adicionar Secret Key" — copie o valor mostrado na hora, porque o DocuSign só exibe a Secret Key uma vez.
Copie as credenciais e conecte no imob365
No imob365, acesse Configurações → Assinatura eletrônica, cole a Integration Key (Client ID) e a Secret Key, clique em "Salvar" e depois em "Conectar DocuSign".
Go-Live — promova a chave pra produção
Este é o passo que mais gente esquece, e o mais comum de dar erro. Uma Integration Key nova do DocuSign nasce no ambiente de testes (demo) — antes de funcionar com contratos e assinaturas reais, ela precisa passar pelo processo de Go-Live do próprio DocuSign, uma validação automática deles que geralmente leva de alguns minutos a poucos dias. O próprio painel do DocuSign avisa quando essa promoção é necessária — siga as instruções que aparecerem lá.
Envie seu primeiro contrato pra assinatura
Com a conexão feita, abra qualquer contrato e role até a seção "Assinatura eletrônica". Clique em "Gerar PDF do contrato" (abre a tela de impressão, já com o modelo certo), baixe o PDF e volte pra anexá-lo em "Anexar PDF gerado". Depois é só clicar em "Solicitar assinatura" pra cada parte — o DocuSign envia o e-mail de assinatura de verdade, e o imob365 atualiza o status sozinho quando a pessoa assinar.
Solução de problemas
Os erros abaixo cobrem os pontos mais prováveis de travar, com base em como a própria API do DocuSign exige que essa conexão seja configurada.
"O DocuSign recusou a autorização"
Confira três coisas, nesta ordem: (1) a Integration Key e a Secret Key coladas no imob365 são exatamente as da aba "Apps e Chaves"; (2) a URI de redirecionamento do passo 2 está cadastrada exatamente igual; (3) sua Integration Key já passou pelo Go-Live do passo 5 — uma chave ainda em modo de testes não autentica contra o ambiente de produção.
"A conexão expirou ou é inválida"
O link de conexão com o DocuSign vale por 10 minutos. Se demorou mais que isso entre abrir a tela de conectar e confirmar do lado do DocuSign, volte em Configurações → Assinatura eletrônica e clique em "Conectar DocuSign" de novo.
Assinatura enviada, mas o signatário não acha onde assinar
O imob365 tenta posicionar automaticamente a área de assinatura procurando o texto "Assinatura:" no PDF enviado. Se o modelo de contrato do seu tenant não tiver esse texto, o envelope ainda é enviado, mas sem a área marcada — é preciso ter "Free Form Signing" habilitado na sua conta DocuSign (opção nas configurações da conta, em "Envio e assinatura") pra a pessoa conseguir assinar em qualquer lugar do documento.
Assinei no DocuSign, mas o status no imob365 continua "Aguardando assinatura"
A confirmação chega via um webhook nativo do DocuSign (Connect), configurado automaticamente quando você conectou a conta. Se ele falhou por algum motivo, desconecte e conecte a conta DocuSign de novo no imob365 — isso recria a configuração do Connect.