Resumo de IA
Gostaria de conectar seus formulários WordPress à sua conta Salesforce? Com o addon Salesforce do WPForms, você pode adicionar automaticamente novos leads aos seus contatos quando os usuários enviarem seus formulários.
Este tutorial mostrará como instalar e usar o addon Salesforce com o WPForms.
Requisitos: Para usar o addon Salesforce, você precisará garantir que:
- Você tem uma licença Elite
- Você instalou a versão mais recente do WPForms para atender à versão mínima exigida para o addon Salesforce
- Seu site carrega via SSL (HTTPS). Confira o guia do WPBeginner sobre como usar HTTPS para mais informações
- Sua edição do Salesforce suporta acesso à API
Instalando o Addon Salesforce
Antes de começar, você precisará garantir que o WPForms esteja instalado e ativado em seu site WordPress.
Assim que você verificar sua licença do WPForms, você poderá instalar e ativar o addon Salesforce rapidamente.
Criando um Novo Aplicativo no Salesforce
Se você ainda não criou uma conta Salesforce, faça isso agora.
Para conectar o WPForms ao Salesforce, você precisa criar um aplicativo em sua conta Salesforce.
Ao fazer login, clique no ícone de engrenagem no canto superior direito da tela e selecione a opção Configuração.
A partir daqui, você pode usar a barra de pesquisa Busca Rápida na barra lateral esquerda para pesquisar por “Aplicativos”.
Nas opções que aparecem na barra lateral esquerda, selecione Aplicativos » Aplicativos de Cliente Externo » Configurações.
Isso mostrará todos os seus aplicativos conectados. A partir daqui, clique no botão Novo Aplicativo Conectado.
Isso abrirá uma lista de opções que você precisará preencher. Campos destacados em vermelho são obrigatórios. Você pode ver uma descrição de cada campo abaixo:
- Nome do Aplicativo Conectado: Um apelido para o seu aplicativo, que seus usuários no Salesforce verão. Pode ser qualquer coisa que você desejar.
- Nome da API: Este campo será preenchido automaticamente com o Nome do Aplicativo Conectado, mas você pode alterá-lo para o que desejar. Se você planeja usar código personalizado para sua integração, seus desenvolvedores precisarão deste nome de API para personalização.
- E-mail de Contato: O e-mail de contato da pessoa que está criando o aplicativo.
Em seguida, você precisará marcar a opção Ativar Configurações OAuth para configurar as permissões do seu aplicativo.
Isso abrirá mais campos que você precisará preencher para concluir a configuração do seu aplicativo, com os campos obrigatórios marcados em vermelho.
Analisamos cada uma dessas configurações em detalhes abaixo.
URL de Retorno
A URL de Retorno é a URL para a qual você será redirecionado após permitir a autorização para seu aplicativo conectado (o que abordaremos mais tarde). Para encontrar sua URL de Retorno, abra seu painel do WordPress em uma nova aba ou janela do navegador.
Em seguida, navegue até WPForms » Configurações » Integrações e clique na integração Salesforce.
Isso se expandirá para mostrar um botão Adicionar Nova Conta.
Clique neste botão para revelar as configurações de integração, incluindo a URL de Retorno do seu site.
Copie a URL de Retorno e deixe esta aba ou janela do navegador aberta, pois você precisará retornar a ela mais tarde.
Depois de copiar sua URL de Retorno, navegue de volta para as configurações do seu aplicativo Salesforce e cole-a no campo URL de Retorno.
Escopos OAuth Selecionados
Os Escopos OAuth Selecionados informam ao Salesforce quais permissões seu aplicativo deve ter. O WPForms precisa apenas de duas permissões: Gerenciar dados do usuário via APIs (api) e Realizar solicitações a qualquer momento (refresh_token, offline_access).
Você pode adicionar essas permissões selecionando cada uma delas na coluna da esquerda e, em seguida, clicando no botão Adicionar.
Depois de adicionar essas permissões, role para baixo e desmarque a opção que diz Exigir Extensão de Chave de Prova para Troca de Código (PKCE) para Fluxos de Autorização Suportados.
Depois disso, role até o final da página e clique no botão Salvar para concluir o processo de configuração do aplicativo personalizado.
Se você configurou seu aplicativo corretamente, o Salesforce deverá redirecioná-lo para uma página com um aviso que diz: As alterações podem levar até 10 minutos para terem efeito. A exclusão de uma organização pai também exclui todos os aplicativos conectados com configurações OAuth habilitadas.
Neste ponto, é recomendado que você espere os 10 minutos completos antes de passar para a próxima etapa. Isso garantirá que seu aplicativo tenha tempo de ter efeito no Salesforce e ajudará você a evitar erros potenciais no processo de conexão.
Após o período de espera de 10 minutos, clique no botão Continuar para visualizar suas informações de API.
Conectando o Salesforce ao WPForms
Depois de abrir suas informações de API, você precisará copiar sua Chave do Consumidor e Segredo do Consumidor para conectar o Salesforce ao WPForms. Para fazer isso, clique no botão Gerenciar Detalhes do Consumidor em API (Habilitar Configurações OAuth).
Chave do Consumidor
Você pode encontrar sua Chave do Consumidor diretamente na seção Detalhes do Consumidor.
Vá em frente e copie essas informações, depois navegue de volta para as configurações do WPForms. Aqui, você precisará colar sua Chave do Consumidor no campo Chave do Consumidor.
Segredo do Consumidor
Clique no botão Copiar ao lado de Segredo do Consumidor para copiar seu segredo de API.
Depois disso, retorne ao painel de administração do WordPress e cole-o nas configurações do WPForms no campo Segredo do Consumidor.
Depois de adicionar sua Chave do Consumidor e Segredo do Consumidor, clique no botão Conectar ao Salesforce.
Isso o redirecionará para a página de login do Salesforce, onde você precisará inserir seu nome de usuário e senha.
Em seguida, o Salesforce perguntará se você deseja permitir o acesso à sua conta. Vá em frente e clique no botão Permitir para finalizar o processo de configuração.
Depois de permitir que o WPForms acesse sua conta do Salesforce, você deverá ser redirecionado de volta às configurações de integrações, onde verá um banner na parte superior da tela informando que a conexão foi bem-sucedida.
Adicionando Integração Salesforce a um Formulário
Depois de vincular sua conta do Salesforce ao WPForms, você estará pronto para conectá-lo aos seus formulários. Para começar, você precisará criar um novo formulário ou editar um existente.
Após abrir o construtor de formulários, você pode adicionar uma nova conexão do Salesforce em Marketing » Salesforce. A partir daqui, você precisará clicar no botão azul Adicionar Nova Conexão.
Isso abrirá uma sobreposição onde você pode adicionar um nome para sua conexão. Seus usuários nunca verão este rótulo. Ele simplesmente serve para ajudá-lo a acompanhar várias conexões.
Para nosso exemplo, nomearemos a conexão Adicionar Novo Contato.
Clique no botão OK para salvar sua conexão, e duas configurações deverão se tornar visíveis:
- Selecionar Conta: Escolha a conta do Salesforce para a qual você deseja enviar os dados do formulário neste menu suspenso.
- Selecionar Objeto do Salesforce: Selecione o tipo de dados que você deseja enviar deste formulário para o Salesforce.
Para nosso exemplo, escolheremos a conta que conectamos nas etapas anteriores deste tutorial no menu suspenso Selecionar Conta. Em seguida, definiremos o Objeto do Salesforce como Contato para que cada envio do nosso formulário adicione um novo contato no Salesforce.
Depois de selecionar um Objeto do Salesforce, mais opções de configuração aparecerão.
- Nome do Campo Personalizado: Estes são campos específicos dentro do Salesforce aos quais você gostaria de mapear seus campos do WPForms. Para nosso exemplo, usaremos o campo padrão Nome Completo e adicionaremos também o campo Email.
- Campos do Formulário: Estes são os campos do seu formulário dos quais você deseja extrair dados para o Salesforce. Para o nosso exemplo, mapearemos Nome Completo para o campo Nome em nosso formulário e mapearemos E-mail para o nosso campo E-mail.
Se você quiser adicionar mais campos personalizados à sua integração, pode clicar no botão mais (+).
Depois de configurar todas as suas configurações, certifique-se de salvar seu formulário.
Testando Seus Formulários
Depois de configurar seu formulário, é uma boa ideia testá-lo no frontend do seu site. Para fazer isso sem publicar o formulário em uma página ativa, você pode usar a opção de visualização de formulário no WPForms ou criar uma página ou postagem privada.
Aqui está um exemplo de alguns dados que você pode usar em sua entrada de teste:
Após enviar sua entrada de teste, vá para sua conta do Salesforce e navegue até o botão mais (+) na parte superior da tela para abrir uma lista completa de guias disponíveis. Para o nosso exemplo, clicaremos em Contatos para ver o novo contato que criamos.
Para ver os detalhes da nossa submissão, clicaremos no nome do contato para abrir o perfil dele.
Isso mostrará os detalhes completos do contato, onde podemos verificar se todos os campos mapeados de nossa submissão foram transferidos corretamente para o Salesforce.
Perguntas Frequentes
Abaixo, discutimos algumas das perguntas mais comuns que recebemos sobre o addon do Salesforce.
Como descubro se posso usar minha edição do Salesforce com o WPForms?
Atualmente, o Salesforce oferece suporte de API apenas para as edições Enterprise, Unlimited, Performance e Developer. Se sua edição não tiver suporte de API, entre em contato com a equipe do Salesforce para mais detalhes sobre como alterar sua edição.
Observação: O suporte de API está disponível para clientes do Salesforce Professional mediante um custo adicional. Para mais informações, acesse a página de preços do Salesforce e clique em Conectar informações de vendas a qualquer aplicativo.
Ao conectar o WPForms ao Salesforce, sou redirecionado para uma página com o erro error=invalid_client_id&error_description=client%20identifier%20invalid. Como corrijo isso?
Isso significa que houve algum problema no processo de configuração (não esperar os 10 minutos completos após a criação do seu aplicativo, configurações incorretas de OAuth ou chaves copiadas incorretamente).
Para corrigir isso, você precisará verificar novamente se habilitou as configurações corretas de OAuth para seu aplicativo no Salesforce e copiou suas chaves de API corretamente.
Se você não esperou os 10 minutos completos após a criação do seu aplicativo antes de tentar uma conexão, precisará atualizar a página após o período de espera e tentar novamente.
Por que não há instruções para criar o aplicativo no Salesforce Classic?
O Salesforce não permite mais que os usuários criem aplicativos conectados na Experiência Clássica. Todas as etapas de criação de aplicativos agora devem ser concluídas usando a Experiência Lightning, que também é a interface padrão para a maioria dos usuários.
Se você estiver usando o Salesforce Classic, recomendamos a mudança para o Lightning para concluir a configuração da integração.
Como posso reenviar envios falhados para o Salesforce?
Se um envio de formulário falhar ao enviar dados para o Salesforce (por exemplo, devido a um problema temporário de conexão ou erro de API), você agora pode reenviá-lo diretamente da página de Entrada Única no seu painel do WPForms.
Para fazer isso, abra a entrada do seu formulário em WPForms » Entradas e clique para visualizar a entrada individual. Uma vez na página de entradas únicas, clique na opção Reenviar para Salesforce na seção Ações.
É isso! Agora você pode instalar e usar o addon Salesforce com o WPForms.
Em seguida, você gostaria de processar pagamentos Authorize.Net através de seus formulários? Certifique-se de conferir nosso guia sobre como configurar e usar o addon Authorize.Net para mais detalhes.