Como fazer a integração da Salesforce com a Clicksign?

Neste guia detalhado, você encontra as informações necessárias para configurar a integração entre a Salesforce e a Clicksign.

A integração funciona como uma comunicação bidirecional: o Salesforce utiliza o Token da Clicksign para enviar documentos e a Clicksign utiliza o Webhook (via Site Salesforce) para enviar as atualizações de status.

Atenção: É necessário utilizar o mesmo e-mail no Salesforce e na Clicksign ao gerar o Token de Autenticação para que a integração funcione corretamente.

Como fazer a configuração inicial no Salesforce?

Nesta etapa, você instala o pacote necessário e prepara o ambiente para receber a integração.

1. Instale o pacote da Clicksign no Salesforce através do link disponibilizado.
2. Escolha a opção de instalação (Administradores, Todos os Usuários ou Perfis Específicos) e clique em Instalar.
3. Aprove o acesso de terceiros, clique em Continuar e, ao finalizar, clique em Concluído.
4. Vá em Configurações > Usuários > selecione seu usuário e, em Atribuição de Conjunto de Permissões, adicione Clicksign Adm e Clicksign Utilização.

Como obter o Token de autenticação na Clicksign?

O sistema solicitará um Token de Autenticação para permitir que o Salesforce envie documentos à Clicksign.

1. Acesse o site da Clicksign, vá em Configurações e depois em API.
2. No campo de e-mail, insira o mesmo e-mail utilizado no seu usuário do Salesforce.
3. Clique em Gerar novo token, copie o código gerado e retorne ao Salesforce.

Como configurar a conexão e segurança no Salesforce?

Agora, você irá inserir as chaves de acesso e configurar os caminhos de rede.

1. No menu do Salesforce, pesquise por Clicksign, clique no ícone da aplicação e selecione Criar.
2. Selecione o ambiente de Produção e insira o domínio do site da Clicksign.
3. Cole o Token gerado anteriormente no campo correspondente e salve.
4. Em Configurações, pesquise por Credenciais Nomeadas
5. Clique no rótulo Clicksign e edite o campo de URL para: https://app.clicksign.com.

Como configurar o Site e o Webhook (Retorno de Status)?

Esta etapa é crucial para que o Salesforce receba as atualizações (como "Assinado") automaticamente.

1. Nas configurações do Salesforce, pesquise por Sites, registre seu domínio e crie um novo site.
2. No campo Home Page ativa, insira exatamente AnswersHome e, em proteção contra Clickjack, selecione Sem proteção.
3. Em Configurações de acesso público > Acesso à classe Apex, adicione a classe PublicRest.
4. Copie a URL gerada pelo Site, vá até o site da Clicksign (em API), clique em Adicionar Webhook, cole o link e selecione todos os eventos desejados.
5. Por fim, no Salesforce, ajuste as Configurações de Site Remoto com a URL atualizada.

Fluxo de Uso: Como enviar um documento?

Após a configuração inicial, siga este passo a passo para o dia a dia:

1. Criação do Envelope

No menu do Salesforce, pesquise por Envelopes e clique em criar. Preencha os dados e salve. Altere o status para Concluído para avançar.

2. Elaboração do Documento

Clique em Criar documento. Selecione um template existente ou faça o upload de um arquivo. Salve e marque o status como Concluído.

3. Configuração dos Signatários

Clique em Criar signatários. Escolha um contato ou insira os dados manualmente. Selecione o documento, avance e marque como Concluído. O status passará para Aguardando Assinatura.

4. Assinatura e Finalização

• Signatário: Recebe o documento, revisa, insere o nome completo e valida com o token SMS (se configurado).
• Finalização: Após a assinatura, retorne ao Salesforce e marque o status como Concluído. O arquivo assinado aparecerá automaticamente dentro da plataforma Salesforce.

Resumo: Você conectou o Salesforce à Clicksign através de um Token de API e configurou um Webhook para que o status da assinatura seja atualizado sem que você precise sair do Salesforce.