Resumo de IA
Gostaria de conectar os seus formulários WordPress à sua conta Salesforce? Com o addon Salesforce do WPForms, pode adicionar automaticamente novos leads aos seus contactos quando os utilizadores enviam os seus formulários.
Este tutorial irá mostrar-lhe como instalar e usar o addon Salesforce com o WPForms.
Requisitos: Para usar o addon Salesforce, terá de garantir que:
- Tem uma licença Elite
- Instalou a versão mais recente do WPForms para cumprir a versão mínima exigida para o addon Salesforce
- O seu site carrega via SSL (HTTPS). Consulte o guia do WPBeginner sobre como usar HTTPS para mais informações
- A sua edição do Salesforce suporta acesso à API
Instalar o Addon Salesforce
Antes de começar, terá primeiro de garantir que o WPForms está instalado e ativado no seu site WordPress.
Assim que tiver verificado a sua licença WPForms, poderá rapidamente instalar e ativar o addon Salesforce.
Criar uma Nova Aplicação no Salesforce
Se ainda não criou uma conta Salesforce, prossiga e crie uma agora.
Para conectar o WPForms com o Salesforce, precisa de criar uma aplicação dentro da sua conta Salesforce.
Quando tiver iniciado sessão, clique no ícone de engrenagem no canto superior direito do ecrã, depois selecione a opção Configurar.
A partir daqui, pode usar a barra de pesquisa Localizar Rápido na barra lateral esquerda para procurar por “Aplicações”.
Nas opções que aparecem na barra lateral esquerda, selecione Aplicações » Aplicações de Cliente Externo » Definições.
Isto mostrará todas as suas aplicações conectadas. A partir daqui, clique no botão Nova Aplicação Conectada.
Isto abrirá uma lista de opções que terá de preencher. Os campos destacados a vermelho são obrigatórios. Pode ver uma descrição de cada campo abaixo:
- Nome da Aplicação Conectada: Um apelido para a sua aplicação, que os seus utilizadores no Salesforce verão. Pode ser qualquer coisa que deseje.
- Nome da API: Este campo será preenchido automaticamente com o Nome da Aplicação Conectada, mas pode alterá-lo para o que desejar. Se planeia usar código personalizado para a sua integração, os seus programadores precisarão deste nome de API para personalização.
- Email de Contacto: O email de contacto da pessoa que está a criar a aplicação.
Em seguida, terá de selecionar a opção Ativar Definições OAuth para configurar as permissões da sua aplicação.
Isto irá apresentar mais campos que terá de preencher para concluir a configuração da sua aplicação, com os campos obrigatórios assinalados a vermelho.
Analisámos cada uma destas definições em detalhe abaixo.
URL de Retorno
O URL de Retorno é o URL para o qual será redirecionado após ter permitido a autorização para a sua aplicação conectada (o que abordaremos mais tarde). Para encontrar o seu URL de Retorno, abra o seu painel WordPress numa nova aba ou janela do navegador.
Em seguida, navegue para WPForms » Definições » Integrações e clique na integração Salesforce.
Isto expandirá para mostrar um botão Adicionar Nova Conta.
Clique neste botão para revelar as definições de integração, incluindo o URL de Retorno do seu site.
Copie o URL de Retorno e deixe esta aba ou janela do navegador aberta, pois terá de regressar a ela mais tarde.
Depois de copiar o seu URL de Retorno, navegue de volta para as definições da sua aplicação Salesforce e cole-o no campo URL de Retorno.
Escopos OAuth Selecionados
Os Escopos OAuth Selecionados indicam ao Salesforce que permissões a sua aplicação deve ter. O WPForms necessita apenas de duas permissões: Gerir dados do utilizador através de APIs (api) e Executar pedidos a qualquer momento (refresh_token, offline_access).
Pode adicionar estas permissões selecionando cada uma delas na coluna da esquerda e, em seguida, clicando no botão Adicionar.
Depois de adicionar estas permissões, role para baixo e desmarque a opção que diz Exigir Chave de Prova para Troca de Código (PKCE) Extensão para Fluxos de Autorização Suportados.
Depois disso, role até ao fundo da página e clique no botão Guardar para concluir o processo de configuração da aplicação personalizada.
Se configurou a sua aplicação corretamente, o Salesforce deverá redirecioná-lo para uma página com um aviso que diz: As alterações podem demorar até 10 minutos a ter efeito. A eliminação de uma organização principal também elimina todas as aplicações conectadas com definições OAuth ativadas.
Neste ponto, recomenda-se que espere os 10 minutos completos antes de passar para o próximo passo. Isto garantirá que a sua aplicação tem tempo para ter efeito no Salesforce e ajudará a evitar erros potenciais no processo de ligação.
Após o período de espera de 10 minutos, clique no botão Continuar para ver as suas informações de API.
Conectar o Salesforce ao WPForms
Depois de abrir as suas informações de API, terá de copiar a sua Chave de Consumidor e Segredo do Consumidor para poder ligar o Salesforce ao WPForms. Para o fazer, clique no botão Gerir Detalhes do Consumidor em API (Ativar Definições OAuth).
Chave de Consumidor
Pode encontrar a sua Chave de Consumidor diretamente na secção Detalhes do Consumidor.
Prossiga e copie esta informação, depois navegue de volta para as suas definições do WPForms. Aqui, terá de colar a sua Chave de Consumidor no campo Chave de Consumidor.
Segredo do Consumidor
Clique no botão Copiar ao lado de Segredo do Consumidor para copiar o seu segredo de API.
Depois disso, regresse ao seu painel de administração do WordPress e cole-o nas suas definições do WPForms no campo Segredo do Consumidor.
Depois de adicionar a sua Chave de Consumidor e o Segredo do Consumidor, clique no botão Conectar ao Salesforce.
Isto irá redirecioná-lo para a página de login do Salesforce, onde terá de introduzir o seu nome de utilizador e palavra-passe.
Em seguida, o Salesforce irá perguntar se pretende permitir o acesso à sua conta. Prossiga e clique no botão Permitir para concluir o processo de configuração.
Depois de permitir que o WPForms aceda à sua conta Salesforce, deverá ser redirecionado de volta para as suas definições de integrações, onde verá um banner no topo do ecrã a informar que a ligação foi bem-sucedida.
Adicionar Integração Salesforce a um Formulário
Depois de ligar a sua conta Salesforce ao WPForms, está pronto para a ligar aos seus formulários. Para começar, terá de criar um novo formulário ou editar um existente.
Após abrir o construtor de formulários, pode adicionar uma nova ligação Salesforce em Marketing » Salesforce. A partir daqui, terá de clicar no botão azul Adicionar Nova Ligação.
Isto abrirá uma sobreposição onde pode adicionar um nome para a sua ligação. Os seus utilizadores nunca verão este rótulo. Destina-se simplesmente a ajudá-lo a acompanhar várias ligações.
Para o nosso exemplo, chamaremos à ligação Adicionar Novo Contacto.
Clique no botão OK para guardar a sua ligação, e duas definições deverão tornar-se visíveis:
- Selecionar Conta: Escolha a conta Salesforce para a qual pretende enviar dados do formulário a partir deste menu suspenso.
- Selecionar Objeto Salesforce: Selecione o tipo de dados que pretende enviar deste formulário para o Salesforce.
Para o nosso exemplo, escolheremos a conta que ligámos nos passos anteriores deste tutorial a partir do menu suspenso Selecionar Conta. Em seguida, definiremos o Objeto Salesforce como Contacto para que cada submissão do nosso formulário adicione um novo contacto no Salesforce.
Depois de selecionar um Objeto Salesforce, aparecerão mais opções de configuração.
- Nome do Campo Personalizado: Estes são campos específicos dentro do Salesforce aos quais pretende mapear os seus campos do WPForms. Para o nosso exemplo, usaremos o campo predefinido Nome Completo e adicionaremos também o campo Email.
- Campos do Formulário: Estes são os campos no seu formulário dos quais pretende extrair dados para o Salesforce. No nosso exemplo, mapearemos o Nome Completo para o campo Nome no nosso formulário e o Email para o nosso campo Email.
Se pretender adicionar mais campos personalizados à sua integração, pode clicar no botão mais (+).
Depois de configurar todas as suas definições, certifique-se de guardar o seu formulário.
Testar os Seus Formulários
Depois de configurar o seu formulário, é uma boa ideia testá-lo no frontend do seu site. Para o fazer sem publicar o formulário numa página ativa, pode usar a opção de pré-visualização do formulário no WPForms ou criar uma página ou publicação privada.
Aqui está um exemplo de alguns dados que poderá usar na sua entrada de teste:
Após submeter a sua entrada de teste, dirija-se à sua conta Salesforce e navegue até ao botão mais (+) na parte superior do ecrã para abrir uma lista completa de separadores disponíveis. No nosso exemplo, clicaremos em Contactos para ver o novo contacto que criámos.
Para ver os detalhes da nossa submissão, clicaremos no nome do contacto para abrir o seu perfil.
Isto mostrará os detalhes completos do contacto, onde podemos verificar se todos os campos mapeados da nossa submissão foram corretamente transferidos para o Salesforce.
Perguntas Frequentes
Abaixo, discutimos algumas das perguntas mais comuns que recebemos sobre o addon Salesforce.
Como posso saber se posso usar a minha edição do Salesforce com o WPForms?
Atualmente, o Salesforce fornece suporte de API apenas para as edições Enterprise, Unlimited, Performance e Developer. Se a sua edição não tiver suporte de API, contacte a equipa do Salesforce para mais detalhes sobre como alterar a sua edição.
Nota: O suporte de API está disponível para clientes Salesforce Professional mediante um custo adicional. Para mais informações, vá à página de preços do Salesforce e clique em Ligar informações de vendas a qualquer aplicação.
Ao ligar o WPForms ao Salesforce, sou redirecionado para uma página com o erro error=invalid_client_id&error_description=client%20identifier%20invalid. Como posso corrigir isto?
Isto significa que houve algum problema no processo de configuração (ou não esperou os 10 minutos completos após a criação da sua aplicação, definições OAuth incorretas ou chaves copiadas incorretamente).
Para corrigir isto, terá de verificar novamente se ativou as definições OAuth corretas para a sua aplicação no Salesforce e copiou as suas chaves de API corretamente.
Se não esperou os 10 minutos completos após a criação da sua aplicação antes de tentar uma ligação, terá de atualizar a página após o período de espera e tentar novamente.
Porque é que não há instruções para criar a aplicação no Salesforce Classic?
O Salesforce já não permite aos utilizadores criar aplicações conectadas na Experiência Clássica. Todos os passos de criação de aplicações devem agora ser concluídos usando a Experiência Lightning, que é também a interface padrão para a maioria dos utilizadores.
Se estiver a usar o Salesforce Classic, recomendamos que mude 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 não conseguir enviar dados para o Salesforce (por exemplo, devido a um problema temporário de ligação ou erro de API), pode agora reenviá-lo diretamente da página de Entrada Única no seu painel WPForms.
Para fazer isto, abra a entrada do seu formulário em WPForms » Entradas e, em seguida, clique para ver a entrada individual. Uma vez na página de entradas únicas, clique na opção Reenviar para Salesforce na secção Ações.
É tudo! Agora pode instalar e usar o complemento Salesforce com o WPForms.
Em seguida, gostaria de processar pagamentos Authorize.Net através dos seus formulários? Certifique-se de que consulta o nosso guia sobre como configurar e usar o complemento Authorize.Net para mais detalhes.