Passar para o conteúdo principal

Como encaminhar leads do Ramper Pipeline para o Ramper Marketing com Webhooks

Como configurar um webhook no Ramper Pipeline para enviar leads ao Ramper Marketing: gatilhos, mapeamento de campos, campos obrigatórios e passo a passo.

Escrito por Vinicius Poleti

O webhook envia dados do seu funil de vendas do Ramper Pipeline diretamente para a base de contatos do Ramper Marketing, em tempo real, sempre que um evento (gatilho) acontece. Esta funcionalidade está disponível em todos os planos.

Gatilhos disponíveis

O webhook pode ser disparado quando: a oportunidade foi adicionada (em qualquer funil e etapa); a oportunidade foi editada; a oportunidade trocou de etapa; ou a oportunidade entrou em uma etapa específica que você definir.

Mapeamento de campos

É preciso mapear os campos das duas ferramentas. No Ramper Pipeline, todos os campos nativos e adicionais ficam disponíveis em uma lista suspensa no menu de configuração do webhook. No Ramper Marketing, você pode usar campos nativos e personalizados.

Campos nativos do Ramper Marketing (use exatamente esta nomenclatura): email_contato, nome_contato, sobrenome, nome_empresa, cargo, site_empresa, site_contato, setor, tel_fixo, tel_empresa, email_empresa, tel_celular, anotacoes, tags, twitter, facebook, facebook_empresa, linkedin, cidade, estado, endereco_empresa, dtaniversario, sexo, motivo_perda, token_api_lahar, nome_formulario.

Campos personalizados: no Ramper Marketing, acesse Geração de Leads > Campos Personalizados, clique em Ações > Editar no campo desejado e copie o Token.

Passo a passo

  1. No Ramper Pipeline, acesse Gerenciar > Integrações e vá até a seção Webhooks > Adicionar/Editar.

  2. Clique em Adicionar Webhooks e preencha: Gatilho (ex.: "Oportunidade entrou na etapa definida" — selecione funil e etapa); Título; e URL de destino: https://app.lahar.com.br/api/conversions

  3. Na aba Avançado, mantenha "Gravar um registro em Eventos ocorridos?" como Sim e selecione o formato POST (WWW-Form-Urlencoded).

  4. Clique em Exibir: configurar campos e faça o mapeamento: em Enviar com o nome, digite o nome do campo do Ramper Marketing; em Usar o campo, selecione o campo do Ramper Pipeline (ou use Incluir: Campo manual para valores fixos).

  5. Marque Sim em "Enviar apenas os campos configurados" e salve.

Campos obrigatórios

Todo webhook deve conter: email_contato (chave primária de identificação); token_api_lahar (token único da sua conta Ramper Marketing); e nome_formulario (nome da conversão no histórico do contato, ex.: "RP - Funil padrão - Prospecção", limite de 100 caracteres).

Enviar TAGs

Use Incluir Campo manual (Texto), digite tags em "Enviar com o nome" e as tags separadas por vírgula no valor (ex.: prospeccao, interessado). ⚠️ Não use acentuação nem caracteres especiais nas tags.

Respondeu à sua pergunta?