A ForSign não tem hoje um conector pronto, no marketplace, para HubSpot, Zapier, Power Automate, n8n ou Make. Mesmo assim, dá para ligar a ForSign a todas elas. Essas ferramentas conseguem chamar uma API por HTTP e receber webhooks. É com esses dois recursos que a integração acontece.
- Para enviar documentos a partir da ferramenta: ela chama a API da ForSign com a chave de API da sua empresa.
- Para reagir ao que acontece na ForSign: a ferramenta recebe um webhook quando alguém assina, preenche o formulário ou quando o documento final fica pronto.
Quando usar
- Enviar o contrato para assinatura quando um negócio muda de etapa no CRM.
- Gravar no CRM as respostas do formulário que o participante preencheu.
- Gravar o PDF assinado no seu sistema quando a operação termina.
- Avisar a equipe num canal interno quando um contrato é assinado.
O que você precisa
-
A chave de API, em Desenvolvedor, aba Configurações. O link Ir para documentação leva às instruções da API. Veja Onde pegar a chave de API.
A chave da API e o link Ir para documentação ficam em Desenvolvedor, aba Configurações. Ver a tela inteira -
Um webhook apontando para a URL que a ferramenta de automação gerou. Veja Configurar um webhook.
Na mesma aba, a seção Webhooks cadastra a URL que a ferramenta de automação vai escutar. Ver a tela inteira
Montar o fluxo na ferramenta
- Gatilho vindo da ForSign. Crie na ferramenta um gatilho do tipo webhook (nomes comuns: "Webhook", "Catch Hook", "When an HTTP request is received"). Copie a URL que ela gerar e cadastre como webhook na ForSign, com o evento que interessa.
- Ação na ForSign. Crie na ferramenta uma ação do tipo requisição HTTP. Envie a chave de API no cabeçalho
X-Api-Keye siga a documentação da API para enviar o documento e criar a operação. - Baixar o documento final. Use o evento Documento Pronto para Download como gatilho e peça o arquivo à API em seguida.
- Alimentar o CRM com o formulário. Use o evento Formulário Preenchido. O aviso traz os campos que o participante preencheu.
- Conclua uma operação de teste e confira cada envio na aba Logs do Painel do desenvolvedor.
O que acontece depois
As operações criadas pela ferramenta aparecem em Minhas operações com a origem API no feed. Os participantes recebem as notificações normais.
Limites e detalhes
- Não há conector nativo nem login "com um clique" para essas ferramentas. A integração usa a API e os webhooks.
- A ferramenta de automação precisa aceitar requisições HTTP e cabeçalhos personalizados.
- Guarde a chave de API no cofre de credenciais da ferramenta, nunca no texto do fluxo.
- Configure a ferramenta para responder rápido ao webhook. A ForSign espera até 30 segundos pela resposta.
- As operações criadas pela API consomem os créditos normais.
Perguntas comuns
A ForSign vai ter um conector para Zapier ou HubSpot? Hoje não há conector nativo. Se a sua empresa precisa de um, conte o caso ao suporte.
Preciso de um programador? Para fluxos simples, não. Quem já monta automações nessas ferramentas consegue configurar o webhook e a requisição HTTP. Para fluxos maiores, um desenvolvedor ajuda.
O webhook pode disparar duas vezes. O fluxo vai duplicar? Pode acontecer quando a ferramenta demora a responder. Use o ID da operação e o tipo de evento para ignorar repetições.