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
No Ramper Pipeline, acesse Gerenciar > Integrações e vá até a seção Webhooks > Adicionar/Editar.
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
Na aba Avançado, mantenha "Gravar um registro em Eventos ocorridos?" como Sim e selecione o formato POST (WWW-Form-Urlencoded).
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).
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.