Gostaria de ligar os seus formulários WordPress à sua conta Salesforce? Com o addon WPForms Salesforce, pode adicionar automaticamente novos contactos aos seus contactos quando os utilizadores enviam os seus formulários.
Este tutorial mostra-lhe como instalar e utilizar o addon Salesforce com o WPForms.
Requisitos: Para utilizar o Salesforce addon, é necessário garantir que:
- Tem uma licença Elite
- Você instalou a versão mais recente do WPForms para atender à versão mínima necessária para o complemento do Salesforce
- O seu site é carregado através de SSL (HTTPS). Consulte o guia do WPBeginner sobre a utilização de HTTPS para obter mais informações
- A sua edição do Salesforce suporta o acesso à API
Instalar o Salesforce Addon
Antes de começar, é necessário certificar-se de que o WPForms está instalado e ativado no seu site WordPress.
Depois de verificar sua licença do WPForms, você poderá instalar e ativar rapidamente o complemento do Salesforce.
Criando um novo aplicativo no Salesforce
Se ainda não criou uma conta do Salesforce, vá em frente e faça-o agora.
Para ligar o WPForms ao Salesforce, é necessário criar uma aplicação na sua conta Salesforce.
Depois de fazer login, verifique se está usando o painel do Salesforce Classic. Para mudar para o painel Classic, clique no ícone do seu perfil no canto superior direito da tela e selecione a opção Mudar para o Salesforce Classic.
Depois de abrir o painel de controlo Classic, clique no separador Configuração na barra de navegação.
A partir daqui, pode utilizar a barra de pesquisa rápida na barra lateral esquerda para procurar "Aplicações".
Nas opções que são apresentadas na barra lateral esquerda, selecione Construir " Criar " Aplicações.
Isto irá redireccioná-lo para uma lista de todas as aplicações disponíveis na sua conta Salesforce. Para adicionar um novo aplicativo conectado, vá até a seção Aplicativos conectados e selecione o botão Novo.
Isto abrirá uma lista de opções que terá de preencher. Os campos assinalados a vermelho são obrigatórios. Pode ver uma descrição de cada campo abaixo:
- Nome do aplicativo conectado: Um apelido para o seu aplicativo, que será visto pelos seus usuários no Salesforce. Pode ser qualquer coisa que você queira.
- Nome da API: Este campo será automaticamente predefinido para o Nome da aplicação ligada, mas pode alterá-lo para o que pretender. Se planeia utilizar código personalizado para a sua integração, o(s) seu(s) programador(es) precisará(ão) deste nome de API para personalização.
- E-mail de contacto: O e-mail de contacto da pessoa que cria a aplicação.
Em seguida, terá de marcar a opção Ativar definições OAuth para configurar as permissões da sua aplicação.
Isto abrirá mais campos que terá de preencher para terminar a configuração da sua aplicação, com os campos obrigatórios assinalados a vermelho.
Analisamos cada uma destas definições em pormenor abaixo.
URL de chamada de retorno
O URL de retorno de chamada é o URL para o qual será redireccionado depois de ter permitido a autorização para a sua aplicação ligada (que abordaremos mais tarde). Para encontrar seu URL de retorno de chamada, abra o painel do WordPress em uma nova guia ou janela do navegador.
Em seguida, navegue até WPForms " Configurações " Integrações e clique na integração do Salesforce.
Esta opção será expandida 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 de chamada do seu site.
Copie o URL de retorno de chamada e deixe este separador ou janela do browser aberto, pois terá de voltar a ele mais tarde.
Depois de copiar seu URL de retorno, volte para as configurações do aplicativo Salesforce e cole-o no campo URL de retorno.
Âmbitos OAuth selecionados
Os Escopos OAuth selecionados informam ao Salesforce quais permissões seu aplicativo deve ter. O WPForms só precisa de duas permissões: Gerenciar dados do usuário via APIs (api) e Executar solicitações 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, desloque-se para baixo e desmarque a opção onde se lê, Exigir chave de prova para troca de código (PKCE) Extensão para fluxos de autorização suportados.
Depois disso, desloque-se para o fundo da página e clique no botão Guardar para concluir o processo de configuração da aplicação personalizada.
Se você configurou seu aplicativo corretamente, o Salesforce deve redirecioná-lo para uma página com um aviso que diz: Aguarde de 2 a 10 minutos para que suas alterações tenham efeito no servidor antes de usar o aplicativo conectado.
Neste ponto, é recomendável aguardar os 10 minutos completos antes de passar para a próxima etapa. Isso garantirá que seu aplicativo tenha tempo para entrar em vigor no Salesforce e ajudará a evitar possíveis erros no processo de conexão.
Após o período de espera de 10 minutos, clique no botão Continuar para ver as informações da API.
Ligar 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 (Ativar configurações do OAuth).
Chave do consumidor
Pode encontrar a sua chave de consumidor diretamente na secção "Detalhes do consumidor".
Vá em frente e copie essas informações e, em seguida, navegue de volta para as configurações do WPForms. Aqui, terá de colar a sua chave de consumidor no campo Consumer Key.
Segredo do consumidor
Clique no botão Copiar junto a 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 Consumer Secret.
Depois de adicionar a Chave do consumidor e o Segredo do consumidor, clique no botão Ligar ao Salesforce.
Isto irá redireccioná-lo para a página de início de sessão do Salesforce, onde terá de introduzir o seu nome de utilizador e palavra-passe.
Em seguida, o Salesforce perguntará se você deseja permitir o acesso à sua conta. Vá em frente e clique no botão Permitir para concluir o processo de configuração.
Depois de permitir que o WPForms acesse sua conta do Salesforce, você deve ser redirecionado para suas configurações de integração, onde verá um banner na parte superior da tela informando que a conexão foi bem-sucedida.
Adicionar a integração do Salesforce a um formulário
Depois de vincular sua conta do Salesforce ao WPForms, você está pronto para conectá-la aos seus formulários. Para começar, é preciso criar um novo formulário ou editar um já existente.
Depois de abrir o construtor de formulários, pode adicionar uma nova ligação ao Salesforce em Marketing " Salesforce. A partir daqui, tem de clicar no botão azul Adicionar nova ligação.
Isto abrirá uma sobreposição onde pode adicionar um nome à sua ligação. Os seus utilizadores nunca verão esta etiqueta. Destina-se simplesmente a ajudá-lo a manter o controlo de várias ligações.
Para o nosso exemplo, designaremos a ligação por Adicionar novo contacto.
Clique no botão OK para guardar a sua ligação, e duas definições devem tornar-se visíveis:
- Selecionar conta: Escolha a conta do Salesforce para a qual pretende enviar os dados do formulário a partir deste menu pendente.
- Selecionar objeto do Salesforce: Selecione o tipo de dados que pretende 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 Salesforce, aparecerão mais opções de configuração.
- Nome do campo personalizado: Estes são campos específicos no Salesforce para os quais você gostaria de mapear seus campos WPForms. Para o nosso exemplo, usaremos o campo padrão Nome completo e adicionaremos o campo E-mail também.
- Valor do campo do formulário: Esses são os campos do formulário dos quais você deseja extrair dados para o Salesforce. No nosso exemplo, vamos mapear Nome completo para o campo Nome no nosso formulário e mapear Email para o nosso campo Email.
Se pretender adicionar mais campos personalizados à sua integração, pode clicar no botão mais (+).
Depois de ter configurado todas as definições, certifique-se de que guarda o 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 em direto, pode utilizar a opção de pré-visualização do formulário no WPForms ou criar uma página ou publicação privada.
Eis um exemplo de alguns dados que pode utilizar na sua entrada de teste:
Depois de enviar sua entrada de teste, vá para sua conta do Salesforce e navegue até o botão de adição (+) na parte superior da tela para abrir uma lista completa de guias disponíveis. No nosso exemplo, vamos clicar em Contactos para ver o novo contacto que criámos.
Para ver os detalhes da nossa apresentação, clicamos 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 passaram corretamente para o Salesforce.
Perguntas mais frequentes
Abaixo, discutimos algumas das perguntas mais comuns que recebemos sobre o complemento do Salesforce.
Como posso saber se posso utilizar a minha edição do Salesforce com o WPForms?
Atualmente, o Salesforce só oferece suporte à API para as edições Enterprise, Unlimited, Performance e Developer. Se sua edição não tiver suporte à API, entre em contato com a equipe do Salesforce para obter mais detalhes sobre como alterar sua edição.
Nota: O suporte à API está disponível para clientes do Salesforce Professional por um custo adicional. Para obter mais informações, vá para a página de preços do Salesforce e clique em Conectar informações de vendas a qualquer aplicativo.
Ao ligar o WPForms ao Salesforce, sou redireccionado para uma página com o erro error=invalid_client_id&error_description=client%20identifier%20invalid. Como é que posso resolver isto?
Isto significa que houve algum problema no processo de configuração (não esperar os 10 minutos completos após a criação da aplicação, definições incorrectas do OAuth ou chaves copiadas incorretamente).
Para corrigir isto, terá de verificar novamente se activou as definições OAuth corretas para a sua aplicação no Salesforce e se copiou corretamente as suas chaves API.
Se não tiver esperado os 10 minutos completos após a criação da aplicação antes de tentar estabelecer uma ligação, terá de atualizar a página após o período de espera e tentar novamente.
É isso aí! Agora você pode instalar e usar o complemento do Salesforce com o WPForms.
Em seguida, gostaria de processar pagamentos do Authorize.Net através dos seus formulários? Não deixe de conferir nosso guia sobre como configurar e usar o addon Authorize.Net para obter mais detalhes.