Para Desenvolvedores: Conectando Formidable Forms

Importante: Os passos descritos neste artigo são destinados a desenvolvedores. Não desenvolvedores podem gerar um código de integração do Formidable Forms com a Ferramenta de Integração do Formidable Forms do Lead Gen & CRM.

 

Ao usar o plugin Formidable Form no WordPress, você precisará seguir alguns passos adicionais para conectá-lo ao Lead Gen & CRM.

---

Conteúdos do Artigo

• Gerando Formidable Forms
• Modificando Código: Valores de ID do Formulário
• Modificando Código: Valores de URL do Post
• Modificando Código: Valores de Rastreamento
• Exemplo de Código Completo 

Usuários:

Administradores	✓
Gerentes de Empresa
Gerentes de Marketing
Gerentes de Vendas
Vendedores
Vendedores Jr.

Gerando Formidable Forms

Não desenvolvedores podem gerar um código de integração do Formidable Forms com a Ferramenta de Integração do Formidable Forms do Lead Gen & CRM.
 

Modificando Código: Valores de ID do Formulário

Devido à forma como o plugin Formidable lida com envios, você não deve colocar o código de formulário nativo diretamente na página. Você ainda precisa gerar o código do formulário nativo, mas precisará adicionar código adicional e fazer algumas alterações no seu arquivo functions.php do WordPress para que funcione.

Para modificar o código do WordPress, faça o seguinte:

1. Abra uma nova aba no seu navegador.
2. Faça login no WordPress nessa aba do navegador.
3. Localize seu arquivo functions.php.
4. Adicione o seguinte trecho de código ao arquivo functions.php:

   add_action('frm_after_create_entry', 'submitSharpSpring', 30, 2);
   
   function submitSharpSpring($entry, $form_id){
   // Um bloco de código será colocado aqui para cada formulário conectado
   } 

5. Adicione o número de ID do formulário, onde XXXX é o número de ID do formulário, na linha $form_id do código: if ($form_id == XXXX) {
6. Se necessário, adicione linhas adicionais de código $form_id para cada formulário conectado. 

Você pode rastrear vários formulários Formidable em uma página colocando seu código de formulário adicional abaixo do primeiro trecho de código do formulário dentro da mesma função. O código de exemplo fornecido tem vários formulários Formidable rastreados na mesma página.
 

Modificando Código: Valores de URL do Post

Uma vez que o código form_id foi adicionado ao arquivo functions.php, você precisará inserir um código post_url. O valor $post_url vem de seu código de incorporação de formulário nativo. É o valor BaseURI seguido pelo valor endpoint.

Para adicionar valores post_url, faça o seguinte:

1. Insira uma linha no arquivo functions.php após os códigos de form_id.

   Considere o seguinte código de exemplo:

   $post_url = 'https://app-3QEBQFRBMQ.marketingautomation.services/webforms/receivePostback/MxYwt7A0MDS3BAA/f91c3547-be72-4429-b964-54f12e24d76c/';

2. Insira o valor $post_url .
3. Abaixo do valor $post_url inserido, insira o seguinte: $body = array(
4. Insira uma linha para cada campo no formulário dentro desta seção.

   Considere o seguinte código de exemplo:

   'first_name' => $_POST['item_meta'][83], 
   'last_name' => $_POST['item_meta'][122],
   'email' => $_POST['item_meta'][90],

5. Repita até que todos os campos que você deseja capturar tenham sido incluídos.

Ao inserir linhas para campos, o rótulo à esquerda pode ser qualquer valor alfanumérico, desde que não inclua ?, /, , ou ().

Isso será usado para mapear os dados para o Lead Gen & CRM. Dar um nome descritivo ao seu campo facilitará o mapeamento. O número entre colchetes à direita de cada linha é o número do campo dentro do Formidable Forms. 

Dentro do Formidable Forms, grupos de checkboxes considerarão cada checkbox como um campo separado. No entanto, o Lead Gen & CRM espera que grupos de checkboxes sejam enviados como uma lista de valores separados por vírgula, que é o padrão HTML para grupos de checkboxes. Se você tiver um grupo de checkboxes, sua linha deve parecer um pouco diferente.

No exemplo a seguir, a entrada 92 é um grupo de checkboxes. Para fazê-lo funcionar com um campo diferente, substitua o número de ID do campo:

'Issues' => implode(',',$_POST['item_meta'][92]), 
 

Modificando Código: Valores de Rastreamento

Uma vez que os códigos form_id e post_url tenham sido adicionados, você pode adicionar um cookie de rastreamento ao formulário. Este campo não aparece ao mapear os campos, e deve sempre ter o nome de ‘trackingid__sb’ com dois sublinhados.

Para adicionar rastreamento, faça o seguinte:

1. Insira uma linha após os códigos de mapeamento de campo post_url no arquivo functions.php.
2. Insira o seguinte código de rastreamento:
   'trackingid__sb' => $_COOKIE['__ss_tk']);
3. Adicione o seguinte código após o código de rastreamento acima:

   $request = new WP_Http();
   $response = $request->post( $post_url, array( 'body' => $body ) );

4. Insira uma chave de fechamento adicional } após o último formulário para fechar toda a função.

   Considere o seguinte código de exemplo:

   );
       $request = new WP_Http();
       $response = $request->post( $post_url, array( 'body' => $body ) );
   }

Exemplo de Código Completo

O código de exemplo fornecido está totalmente formado com um único formulário (Formidable Form 6) sendo capturado, juntamente com notas relevantes.

add_action('frm_after_create_entry', 'submitSharpSpring', 30, 2);

function submitSharpSpring($entry, $form_id){

if ($form_id == 6) { // Este será o número do formulário conforme definido no Formidable. Este é um exemplo de captura do Formulário 6.
        // A linha abaixo é construída usando seu código de formulário nativo. O valor BaseURI forma a primeira parte da URL, seguido pelo endpoint.
        $post_url = 'https://app-3QEBQFRBMQ.marketingautomation.services/webforms/receivePostback/MzYwt7A0MDS3BAA/f91c3547-be72-4429-b964-54f12e24d76c/';
        $body = array(

            // Deve haver uma linha para cada campo no seu formulário. O nome à esquerda é como o Lead Gen & CRM receberá. O número à direita
            // é o número do campo dentro do Lead Gen & CRM.
            'first_name' => $_POST['item_meta'][83], 
            'last_name' => $_POST['item_meta'][122],
            'email' => $_POST['item_meta'][90],
            // A linha abaixo para 'Issues' é um exemplo de como um grupo de checkboxes seria adicionado. Use este método apenas se o campo for um grupo de checkboxes.
            'Issues' => implode(',',$_POST['item_meta'][92]),

            // Esta linha deve estar presente além dos seus campos para capturar o cookie e estabelecer o rastreamento no dispositivo.
            'trackingid__sb' => $_COOKIE['__ss_tk']
            );

        $request = new WP_Http();
        $response = $request->post( $post_url, array( 'body' => $body ) );
    }
}