Configurar Documentos grandes e Serviço de contratos por push

Última atualização em 28 de mar de 2024

Visão geral

O Adobe Acrobat Sign for Salesforce: Guia de serviço de documentos grandes e contratos por mensagem de push explica como configurar o Acrobat Sign para Salesforce para enviar Documentos grandes (maiores que 4,0 MB na página Enviar contrato e 9,0 MB ao enviar em lote) ou enviar Contratos por mensagem de push criados fora do ambiente do Salesforce.

Para estabelecer e usar os serviços de Documentos grandes e Contrato por mensagem de push, você deve definir o ambiente de retorno de chamada. O ambiente de retorno de chamada pode ser usado para um ou ambos os serviços. O ambiente de retorno de chamada exige a criação de um utilizador e perfil novos e dedicados, que assegurem que:

Um conjunto de permissões conhecido e minimamente autorizado está em vigor.
A funcionalidade não é interrompida devido a uma desativação do usuário.

Para estabelecer o ambiente de retorno de chamada e usar os serviços de Documentos grandes e Contratos por mensagem de push, você deve concluir as seguintes etapas:

Verificar pré-requisitos

Você deve ter o pacote Adobe Acrobat Sign para Salesforce instalado.
Você deve ter configurado Meu domínio para permitir a autenticação OAuth do Usuário de retorno de chamada.

Nota

A edição profissional do Salesforce não é compatível com transações de documentos grandes ou contratos por push.

Fazer logon no Salesforce

Definir o usuário do retorno de chamada

Você deve criar um usuário dedicado para conceder permissões de objeto para o processo de retorno de chamada. Para fazer isso:

Faça logon na sua conta do Acrobat Sign para Salesforce usando credenciais de administração.

Acesse Configuração > Administração > Usuários > Perfis.

Localize Usuário padrão na lista de perfis de usuário e selecione Clonar para a listagem.

Defina o usuário ou usuária de retorno de chamada no Acrobat Sign para Salesforce.

Na página Clonar perfil, forneça um nome de perfil e selecione Salvar.

O perfil de exemplo aqui usa 'Usuário de callback de demonstração' como o nome do perfil.

Criar um perfil de usuário de retorno de chamada no Acrobat Sign para Salesforce.

Siga as etapas abaixo para criar um novo usuário ou usuária usando uma licença Salesforce padrão:

No painel esquerdo, selecione Usuários.
Na página Usuários, selecione Novo usuário.
Na página Novo usuário, forneça um nome intuitivo, atribua uma licença do Salesforce e atribua o perfil criado acima. Selecione Salvar.

Crie um novo perfil de usuário de retorno de chamada no Acrobat Sign para Salesforce.

Adicione o conjunto de permissões do 'Usuário de integração do Adobe Acrobat Sign' ao usuário de retorno de chamada usando as seguintes etapas:

Acesse Configuração > Administração > Usuários > Usuários.
Clique no link Nome completo do usuário de retorno de chamada.
Passe o mouse sobre Atribuições de conjunto de permissões e selecione Editar Atribuições.

Na página Atribuição de conjunto de permissões:

Em Conjuntos de permissões disponíveis, selecione Usuário de integração do Adobe Acrobat Sign.
Clique em Adicionar para mover o conjunto de permissões para a coluna Ativado.
Selecione Salvar.

Adicione o Usuário de integração do Adobe Acrobat Sign ao Acrobat Sign para Salesforce.

Vincule o usuário ao Acrobat Sign usando as etapas correspondentes ao ambiente que você está usando.

Faça logon como usuário de retorno de chamada recém-criado.
Acesse Iniciador de aplicativos > Admin do Adobe Acrobat Sign.
Em Usuário de callback, selecione Vincular uma conta.
Na caixa de diálogo Permitir acesso, selecione Permitir.
\nEle solicita que você faça login na sua conta do Salesforce novamente.
Após fazer logon, acesse a página Admin do Adobe Acrobat Sign e verifique se o usuário de callback está vinculado.

Vincule a conta de retorno de chamada na página do administrador do Acrobat Sign para Salesforce.

Fazer logon na conta Acrobat Sign para Salesforce usando o perfil padrão de administrador do sistema.
Na página Lightning “Sign para Salesforce”, selecione a guia Administrador do Adobe Acrobat Sign.
Em Usuário de retorno de chamada, selecione Vincular uma conta.
Na caixa de diálogo Permitir acesso, selecione Não é você?
Na página de logon do Salesforce, insira as credenciais do usuário de retorno de chamada e faça logon.

Isso leva você de volta à página do administrador do Adobe Acrobat Sign. Verifique se o usuário de retorno de chamada está vinculado.

Vincular o usuário de retorno de chamada para a Commercial Cloud do “Acrobat Sign for Salesforce”.

Faça logon na conta do Salesforce do usuário de retorno de chamada do Acrobat Sign.

Estabelecer o site de retorno de chamada

Na Commercial Cloud, admins do Acrobat Sign devem estabelecer e configurar um site especificamente para o retorno de chamada do Adobe Acrobat Sign. Essa configuração garante que as atualizações do contrato sejam enviadas imediatamente para o Salesforce e que documentos grandes possam ser baixados facilmente. Observe que o recurso de contratos por push não está disponível para usuários da Government Cloud.

Nota

Antes de usar os sites do Salesforce na sua organização, você deve registrar um domínio Force.com, que é usado para todos os sites do Salesforce na sua conta. Escolha um nome de domínio curto para evitar exceder o limite de 255 caracteres do Adobe Acrobat Sign para URLs de retorno de chamada.

Usando a barra Configuração de pesquisa na parte superior, procure por Sites e, nos resultados da pesquisa, selecione Sites. Como alternativa, navegue até Configurações > Ferramentas da plataforma > Interface > Sites e domínios > Sites.

Se deseja usar um site já registrado, ignore esta etapa.

Se esse não for o caso, siga estas etapas para registrar o nome de domínio do site:

Insira o nome de domínio desejado no campo de texto após https://
Selecione Verificar disponibilidade para garantir que o domínio esteja disponível. Assim que você tiver um domínio disponível, uma mensagem de sucesso é exibida.
Aceite os Termos de uso e clique em Registrar o domínio Force.com.

Na página atualizada, selecione Novo.

Na página Edição de site:

Defina o valor Rótulo do site como Retorno de chamada do Adobe Acrobat Sign.
Selecione o campo Nome do site. Ele define automaticamente o valor como Adobe_Acrobat_Sign_Callback.
Defina o valor Contato do site para um usuário do Salesforce que receberá as notificações sobre os Sites. Na maioria dos casos, ele é o administrador da conta.
Defina o valor Endereço padrão da Web como AdobeAcrobatSignCallback.
Marque a caixa de seleção Ativo.
Defina o valor Página inicial do local principal como EchoSignCallback.
\nEchoSign é um nome legado para o Adobe Acrobat Sign.
Clique em Salvar.

Crie um site de retorno de chamada no Acrobat Sign for Salesforce.

Adicione os intervalos de IP para configurações de acesso público no Site para restringi-los a IPs do Adobe Acrobat Sign. Para fazer isso:

Na página Detalhes do site do Site de retorno de chamada, clique em Configurações de acesso público.
Selecione Intervalos de IP de logon.
Selecione Novo.
Na caixa de diálogo Intervalos de IP para fazer logon, insira o primeiro intervalo de endereço IP:
- Endereço IP inicial: 52.71.63.224
- Endereço IP final: 52.71.63.255
- Descrição: Acrobat Sign
Selecione Salvar.
Repita as etapas de 2 a 5 para os intervalos de IP listados na tabela abaixo.

Para determinar os intervalos de IP associados à sua região, consulte uma das seguintes listas de endereços IP com base no ambiente que você está usando:

[Importante] Antes de abril de 2024, você deve adicionar os seguintes novos endereços IP:

Intervalos de IP principais	Intervalos de IP do webhook
Nenhuma	3.24.56.173
	3.105.122.20
	13.238.64.177

Intervalos de IP principais		Intervalos de IP do webhook
4.175.107.32/28	20.61.140.48/28	3.66.122.19
4.175.108.80/28	20.61.140.128/28	3.77.229.112
4.175.110.0/28	20.61.140.144/28	3.79.169.198
4.175.111.0/28	20.61.140.224/28	4.208.68.176/28
4.208.52.80/28	20.61.140.240/28	4.208.68.208/28
4.208.52.96/28	20.61.141.0/28	4.208.68.224/28
4.208.52.112/28	51.105.155.160/28	4.208.69.64/28
4.208.52.160/28	51.105.221.164	20.50.247.192/28
4.208.53.48/28	51.145.184.32/28	20.50.247.208/28
4.208.53.64/28	51.145.186.160/28	20.54.200.16/28
4.208.53.80/28	51.145.190.176/28	20.54.201.96/28
4.208.53.96/28	51.145.190.192/28	52.215.99.205
4.208.53.112/28	52.236.2.148	54.217.241.182
4.208.53.128/28	108.141.8.0/28	54.246.37.130
4.208.53.144/28	108.141.9.0/28
4.208.53.160/28	108.141.9.112/28
4.208.53.176/28	108.141.9.128/28
4.208.53.192/28	108.141.9.144/28
4.208.53.208/28	108.141.9.160/28
4.208.53.224/28	108.141.9.176/28
20.56.238.208/28	108.141.9.192/28
20.56.239.128/28	108.141.9.208/28
20.56.239.96/28	108.141.9.224/28
20.61.137.144/28	108.141.9.240/28
20.61.139.192/28	108.141.10.0/28

Intervalos de IP principais	Intervalos de IP do webhook
Nenhuma	3.6.197.59
	13.200.122.115
	35.154.248.184

Intervalos de IP principais	Intervalos de IP do webhook
Nenhuma	35.79.243.232
	52.195.144.38
	52.198.1.183

Intervalos de IP principais		Intervalos de IP do webhook
4.152.91.192/28	20.115.180.32/28	4.246.0.0/28	20.94.106.176/28
4.152.91.208/28	20.115.180.48/28	4.246.0.16/28	20.94.106.192/28
4.152.91.224/28	20.115.180.64/28	4.246.0.32/28	20.94.106.208/28
4.152.91.240/28	20.115.180.80/28	4.246.0.48/28	20.94.106.224/28
4.152.92.0/28	20.115.180.96/28	4.246.0.64/28	20.94.106.240/28
4.152.92.16/28	20.115.180.112/28	4.246.0.80/28	20.94.107.96/28
4.152.92.32/28	20.115.180.192/28	4.246.0.96/28	20.94.107.176/28
4.152.92.48/28	20.115.180.224/28	4.246.0.112/28	20.115.199.160/28
4.152.92.64/28	20.7.248.208/28	4.246.0.128/28	20.115.199.176/28
4.152.92.80/28	20.7.249.0/28	4.246.0.144/28	20.115.199.192/28
4.152.92.96/28	20.7.249.16/28	20.94.104.176/28	20.115.199.208/28
4.152.92.112/28	20.7.249.64/28	20.94.104.240/28	20.115.199.224/28
4.152.92.128/28	20.7.249.80/28	20.94.105.240/28	20.115.199.240/28
4.152.92.144/28	20.7.249.128/28	20.94.105.32/28	34.214.40.128
4.152.92.160/28	20.7.249.144/28	20.94.105.96/28	35.162.126.140
4.152.92.176/28	20.7.250.96/28	20.94.105.160/28	44.212.163.32
4.152.210.201	20.7.250.112/28	20.94.105.208/28	52.1.219.111
20.115.179.0/28	20.7.250.128/28	20.94.106.16/28	52.33.110.59
20.115.179.48/28	20.7.250.144/28	20.94.106.160/28	54.161.158.12
20.115.179.112/28	20.7.251.0/28
20.115.179.128/28	20.7.251.16/28
20.115.179.160/28	20.7.251.32/28
20.115.179.176/28	20.7.251.96/28
20.115.179.192/28	20.7.251.112/28
20.115.179.224/28	52.236.2.148

Intervalos de IP principais		Intervalos de IP do webhook
20.205.219.224/28	20.247.203.64/28	4.144.129.160/28
20.205.220.80/28	20.247.203.112/28	4.144.129.176/28
20.205.220.96/28	20.247.203.208/28	4.144.130.192/28
20.205.220.112/28	20.247.203.224/28	4.144.130.96/28
20.205.222.128/28	20.247.204.0/28	4.144.131.0/28
20.205.223.224/28	20.247.204.16/28	4.144.131.112/28
20.205.223.240/28	20.247.204.112/28	4.144.131.144/28
20.247.200.240/28	20.247.204.128/28	4.144.131.16/28
20.247.201.240/28	20.247.204.144/28	4.144.131.32/28
20.247.202.48/28	20.247.204.176/28	4.144.131.48/28
20.247.202.112/28	20.247.204.224/28	4.144.131.64/28
20.247.202.128/28	20.247.204.240/28	4.144.131.80/28
20.247.202.160/28	20.247.205.0/28	4.144.131.96/28
20.247.202.240/28	20.247.205.64/28	4.144.132.16/28
20.247.203.0/28	20.247.205.80/28	4.144.132.80/28
20.247.203.32/28	20.247.205.96/28	20.6.7.240/28
40.119.212.52

Intervalos de IP principais

4.246.0.144/28
13.55.51.87
13.55.172.219
13.55.174.148
20.36.219.136
20.36.220.46
20.197.114.7

20.197.115.164
35.154.168.186
35.154.250.71
35.156.156.191
35.157.18.96
51.105.160.39
51.105.163.48

52.204.112.48
52.205.27.150
52.24.229.94
52.24.62.165
52.25.112.104
52.184.233.100
52.184.233.96/28

52.199.157.146
52.211.233.170
52.213.27.89
52.213.4.207
54.64.99.195
54.205.20.91

Nota

Se você estiver usando o ambiente Sandbox do Acrobat Sign, deverá consultar as faixas de IP para o endereço do Sandbox.

Lista de exemplos de intervalos de endereços IP:

IP inicial	IP final	Descrição
13.126.23.0	13.126.23.31	Adobe Acrobat Sign
3.236.206.64	3.236.206.95	Adobe Acrobat Sign
40.67.154.249	40.67.154.249	Adobe Acrobat Sign
40.67.155.112	40.67.155.112	Adobe Acrobat Sign
40.67.155.147	40.67.155.147	Adobe Acrobat Sign
40.67.155.185	40.67.155.185	Adobe Acrobat Sign
44.234.124.128	44.234.124.159	Adobe Acrobat Sign
51.105.221.160	51.105.221.191	Adobe Acrobat Sign
52.196.191.224	52.196.191.255	Adobe Acrobat Sign
52.35.253.64	52.35.253.95	Adobe Acrobat Sign
52.48.127.160	52.48.127.191	Adobe Acrobat Sign
52.58.63.192	52.58.63.223	Adobe Acrobat Sign
52.65.255.192	52.65.255.223	Adobe Acrobat Sign
52.71.63.224	52.71.63.255	Adobe Acrobat Sign

Os intervalos de IP finais de logon para o site de retorno de chamada do Adobe Acrobat Sign devem ser exibidos da seguinte forma:

Nota

Se você receber um erro "A lista de faixas de IP não cobre seu endereço IP atual….", ative a opção Salvar esta faixa de IP mesmo que ela não cubra meu endereço IP atual e depois selecione Salvar.

Configurar serviços individuais

Documentos grandes fornecem suporte padrão para o envio de transações e ações em segundo plano, cada uma com seu próprio limite de tamanho, da seguinte maneira:

Enviar transações— Você pode enviar um único documento ou vários documentos totalizando até 4,0 MB por meio da opção 'Enviar para assinatura' na página Contratos.
\n
Ações em segundo plano: permitem o envio de um único documento ou vários documentos com um tamanho total de até 9,0 MB. Para obter mais detalhes, consulte o Guia de personalização avançado.

Para permitir o envio de documentos grandes, você deve concluir as seguintes etapas:

Edite o perfil do usuário de retorno de chamada para conceder acesso adicional.
Ative a classe Apex LargeFileDownloadService no site.
Atualize as configurações personalizadas para usar o URL do retorno de chamada.

Editar o perfil do usuário de retorno de chamada

Para habilitar as permissões de nível de objeto para o usuário do site de retorno de chamada do Adobe Acrobat Sign:

Navegue até a página Perfis, encontre o usuário de retorno de chamada que você criou (neste exemplo, o usuário de retorno de chamada de demonstração) e selecione Editar.
Role a tela para baixo até Permissões de objeto personalizadas e habilite todas as permissões do objeto Contratos: ler, criar, editar, excluir, exibir tudo, modificar tudo.
Selecione Salvar.

Configure o Acrobat Sign para Salesforce para enviar documentos grandes.

Habilitar a classe LargeFileDownloadService do Apex

Você deve ajustar o site de retorno de chamada do Adobe Acrobat Sign para tornar visível a classe “LargeFileDownloadService” do Apex.

As instruções abaixo estão alinhadas à interface de perfil aprimorada. Para obter detalhes sobre interfaces de perfil, consulte Perfis do Salesforce.

Selecione o site de Retorno de chamada do Adobe Acrobat Sign.

Selecione Configurações de acesso público.

Selecione Acesso à classe Apex habilitado e depois selecione Editar.

Na lista Classes do Apex disponíveis à esquerda, selecione echosign_dev1.LargeFileDownloadService e clique em Adicionar para movê-lo para a lista Classes do Apex ativadas. Em seguida, clique em Salvar.

Atualizar as configurações personalizadas para usar o URL do retorno de chamada

Usando a barra Configuração de pesquisa na parte superior, procure por Sites e, nos resultados da pesquisa, selecione Sites.

Como alternativa, navegue até Configuração > Interface > Sites e domínios > Sites.

Selecione Retorno de chamada do Adobe Acrobat Sign.

Na seção URLs personalizados, selecione Exibir.

Na nova guia que abrir, copie o valor da URL no navegador e cole-o em um documento de texto.
\nA URL deve se parecer com: https://<meu-dominio>.my.salesforce-sites.com/AdobeSignCallback
\n

Acesse Configuração > Ferramentas da plataforma > Código personalizado > Configurações personalizadas.

Para o rótulo Configurações do Adobe Sign, selecione Gerenciar > Editar ou Novo.

Na página Editar configurações do Adobe Acrobat Sign:

No campo URL de retorno de chamada da Adobe para o local do Salesforce, cole a URL do 'Endereço web seguro' que você copiou após configurar seu local de retorno de chamada do Adobe Acrobat Sign.
\nVerifique se o prefixo do endereço é "https" e não "http".
Clique em Salvar.

Isso habilita o serviço de documentos grandes.

A API do Acrobat Sign permite enviar solicitações de assinatura, criar formulários web e incorporá-los no seu site. Esses contratos são então enviados e criados no Salesforce como se tivessem sido enviados diretamente dele. Você também pode enviar contratos por meio do aplicativo web adobesign.com, e eles serão sincronizados novamente com o Salesforce.

Para habilitar os contratos de push:

Adicione a página “EchoSignAgreementPushCallback” do Visualforce no site de retorno de chamada.
Edite as permissões do site no nível do objeto e do campo.
Opcionalmente, adicione configurações específicas.

Nota

Para permitir que os contratos de retorno de chamada por push funcionem adequadamente após a migração do webhook 2.0, você deve adicionar os endereços IP do webhook ao perfil de usuário de retorno de chamada do local.

Adicionar a página “EchoSignAgreementPushCallback” do Visualforce no site de retorno de chamada

Usando a barra Configuração de pesquisa na parte superior, procure por Sites e, nos resultados da pesquisa, selecione Sites.

Como alternativa, navegue até Configuração > Ferramentas da plataforma > Interface > Sites e domínios > Sites.

Selecione Retorno de chamada do Adobe Acrobat Sign.

Configure o site de retorno de chamada para enviar contratos para o Acrobat Sign para Salesforce.

Role a tela até a seção Páginas de site do Visualforce e clique em Editar.

Na página de acesso Habilitar página do Visualforce:

Na lista de páginas disponíveis do Visualforce, localize e selecione echosign_dev1.EchoSignAgreementPushCallback.
Selecione Adicionar.
\nMove a página para a lista de Páginas Visualforce habilitadas.
Selecione Salvar.

Configure o Acrobat Sign para Salesforce para enviar documentos de volta para o Salesforce.

Editar as permissões do site no nível do objeto e do campo

Após adicionar a página do Visualforce, ocorre um redirecionamento para a página de Detalhes do site do retorno de chamada. Siga as etapas abaixo para editar a página:

Selecione Configurações de acesso público.
Na página Perfil de retorno de chamada do Adobe Acrobat Sign, selecione Editar.
Role para baixo até a seção Permissões de objetos padrão.
Habilite as permissões de Leitura e Criação para os seguintes objetos: Conta, Contatos, Contratos, Leads e Oportunidades.
Selecione Salvar.
Você retornará ao perfil de retorno de chamada.
Para fazer ajustes no nível de campo quando necessário, role para baixo até a seção Segurança de nível de campo e edite as configurações dos seguintes campos, conforme descrito:
- Contato
  - Conta: certifique-se de marcar as caixas de seleção Acesso de leitura e Acesso de edição.
  - Email: certifique-se de marcar as caixas de seleção Acesso de leitura e Acesso de edição.
  - Nome: certifique-se de marcar as caixas de seleção Acesso de leitura e Acesso de edição.
- Lead
  - Empresa: certifique-se de marcar as caixas de seleção Acesso de leitura e Acesso de edição.
  - Email: certifique-se de marcar as caixas de seleção Acesso de leitura e Acesso de edição.
  - Nome: certifique-se de marcar as caixas de seleção Acesso de leitura e Acesso de edição.

Adicionar configurações específicas

Para que todos os contratos enviados para fora do Acrobat Sign em sua conta sejam criados e transferidos para o Salesforce, siga estas etapas:

Copie o endereço de URL seguro do site de retorno de chamada do Acrobat Sign que você criou e anexe /echosign_dev1__EchoSignAgreementPushCallback para compor o URL de retorno de chamada.

Entre em contato com o suporte da Adobe e forneça a eles sua URL de retorno de chamada para defini-la como a URL de retorno de chamada padrão da sua conta do Adobe Acrobat Sign.
\n
\nExemplo: Se o endereço do seu local for https://<MeuDominio>.my.salesforce-sites.com/AdobeSignCallback, sua URL da API do Acrobat Sign deve ser: https://<MeuDominio>.my.salesforce-sites.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback.
\n

O suporte da Adobe deve inserir sua ID de usuário do Adobe Acrobat Sign para definir o URL de retorno de chamada padrão da API. Verifique se todas as contas do Salesforce estão configuradas para adicionar a chave do documento no URL de retorno de chamada.

Para enviar contratos por meio da API:

Copie o URL seguro do site de retorno de chamada do Adobe Sign que você criou e anexe /echosign_dev1__EchoSignAgreementPushCallback para criar o URL de retorno de chamada para a API do Adobe Acrobat Sign.

Exemplo: se o endereço do site for https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback, o URL da API do Acrobat Sign deve ser: https://<MyDomain>.my.salesforce-sites.com/AdobeSignCallback/echosign_dev1__EchoSignAgreementPushCallback

Ao enviar um contrato ou criar formulários web por meio da API, você deve fornecer uma URL de retorno de chamada.
\nConsulte a lista atual de métodos da API de documento do Acrobat Sign e veja o parâmetro da API 'CallbackInfo'.

Certifique-se de que as configurações da sua conta estão definidas para anexar a chave do documento à URL de retorno de chamada, que deve ser o padrão para clientes do Salesforce que usam o Adobe Sign.
Para qualquer problema, entre em contato com o suporte da Adobe.

Acesse Configurações de mapeamentos por push para definir as preferências de como os registros são criados quando os contratos são enviados ao Salesforce.

Simplifique seu trabalho com o Acrobat Sign
Gerencie e assine documentos online de forma rápida e fácil.

Abra o aplicativo

Uso do Acrobat Sign Document Builder for Salesforce

Adobe Acrobat Sign para Salesforce - Guia do desenvolvedor

Saiba mais

Aprenda com tutoriais em vídeo passo a passo e orientações práticas diretamente no aplicativo.

Comunidade

Participe de discussões, encontre respostas, aprenda com especialistas e compartilhe seus conhecimentos.

Página inicial da Adobe

Acesse seus aplicativos, serviços, gerenciamento de arquivos favoritos da Creative Cloud e muito mais.