Integrations
      Voltar para o início
      1. Central de Ajuda
      2. Ion
      3. Integrations

      Salesforce: poste dados usando o código SFDC web-to-lead

      Pronto para criar leads em tempo real na sua plataforma SFDC? Excelente! Este documento fornece instruções passo a passo para configurar uma integração, post to web form no Ion.

      Antes de começar

      Existem alguns itens que você precisa configurar no Salesforce antes de configurar a integração em Ion. São os seguintes:

      • Código SFDC web-to-lead
      • O código SFDC web-to-lead incluirá os nomes dos campos SFDC, campos “ocultos” (Hidden fields) obrigatórios e o URL da postagem.
      • No Salesforce, clique em Setup > APP Setup > Leads > Web to Lead.

      Existem algumas coisas em Ion que você precisa fazer para configurar a integração. Elas estão listadas abaixo:

      • Criar Data collection fields.
      • Criar os seguintes campos ocultos(hidden fields) para integração SFDC web-to-lead com os seguintes nomes:
        • oid
        • retURL
      • Criar un(s) Ion form(s).
      • Configurar publicação de teste. 

      Vamos começar!

      1. Crie Field mapping

      Ao seguir as etapas abaixo, você mapeará os campos de Ion para os campos correspondentes na sua SFDC API. Certifique-se de adicionar os SFDC hidden fields(campos oculos) ao mapeamento de campo. Para esses campos ocultos, você usará os valores do código Web-to-lead como valores padrão(default) no mapeamento de campo. Para começar, adicione um novo mapeamento de campo(Field mapping).

      1. Clique na guia Integrations, no painel de navegação esquerdo do Ion Console.
      2. Clique no botão verde New field mapping.
      3. Rotule o Field mapping e, opcionalmente, adicione uma descrição.
      4. No menu Integration type, selecione Post to Web Form.
      5. Salve.

      2. Adicione Outbound fields ao Field mapping

      Os Outbound fields definem os dados que você exporta de Ion para seu External web form.

      1. Clique no botão verde New outbound field para adicionar um novo campo ao seu Field mapping.
      2. Ao adicionar um novo campo, você pode selecionar nos menus suspensos Data Collection, Core Field, implementar um Mashup template ou adicionar um campo via JavaScript.
      • Para adicionar um Form field, use os menus suspensos Data Collection para selecionar a Data field category e o Data collection field.
      • OU, para adicionar um Ion Core field, selecione o menu suspenso Core Field.
      • OU, para exportar vários Ion fields para um External field, escolha Mashup e conecte , etc. no editor.
      • OU, para reformatar um valor antes de exportar, escolha o código Javascript e adicione lógica em torno do valor coletado no Ion. Para acessar os Data collection fields via Javascript, use respondent.dataname.

      3. Opcionalmente, torne seu campo obrigatório para executar a integração.

      4. Opcionalmente, adicione um valor padrão.

      5. Insira o nome do campo externo.

      6. Salve.

      7. Repita essas etapas para cada campo que deve ser incluído no Field mapping.

      8. Pule os Inbound fields.

      3. Crie uma integração

      1. Navegue de volta para a tela de Integrations.
      2. Clique na aba Integrations.
      3. Clique no botão verde New integration.
      4. Insira o Label.
      5. Opcionalmente, adicione uma descrição.
      6. Selecione o Field mapping que você acabou de criar.
      7. Defina o máximo de Retries.
      • Se houver uma interrupção do serviço com a plataforma externa, o Ion tentará novamente a postagem por quantas tentativas você indicar aqui.

      8. Cole o URL da postagem SFDC do código Web-to-lead no campo POST URL.

      9. Pule as caixas de seleção Special requirements.

      10. Selecione Post como o método.

      11. Opcionalmente, adicione o Debug email address.

      • Os endereços de e-mail especificados aqui receberão um e-mail sempre que a integração for executada, exibindo os dados postados e a resposta recebida. Esse é um recurso normalmente usado apenas para teste e solução de problemas.

      12. Pule Save Response as e Authentication options.

      13. Salve. 

      4. Adicione a integração às Ion pages

      A plataforma Ion executa a integração com base nas regras que você cria. As regras podem ser adicionadas a qualquer item acionável no seu Ion creative. As regras de integração são normalmente executadas no nível do formulário, no envio do formulário ou em uma etapa de avaliação. Siga as etapas abaixo para adicionar a integração às suas Ion pages.

      1. Navegue até a publicação.
      2. Clique no formulário, botão ou link que você deseja fazer o gatilho para executar sua integração.
      3. No Creative Studio, clique em +rules.
      4. Selecione a condição que precisa ser atendida para executar a integração.
      • No conditions required é normalmente usado.

      5. Selecione SFDC integration como a ação.

      6. Salve.

      5. Teste a integração

      Para testar sua integração, use a publicação de teste que você configurou antes de iniciar as etapas de integração. Observe que as integrações não são executadas no modo de visualização, portanto, você deve abrir um URL para teste. A integração será executada assim que você enviar o Ion Form ou concluir a ação que executa a regra de integração. Se você estiver na Debug email distribution list, você receberá um e-mail que indica se o seu teste foi criado no SFDC. Você também pode verificar se o lead foi criado na sua instância SFDC.

      Bom trabalho!

      Após concluir essas etapas, sua integração está pronta para uso. Você pode adicionar a regra para executar a integração em todas as publicações aplicáveis. 

      Caso você tenha dúvidas, por favor, entre em contato conosco help@rockcontent.com. 😀