Esta funcionalidade está disponível em todos os planos do Ramper Marketing. Neste tutorial você vai aprender a configurar um webhook no Pipeline para enviar automaticamente os leads para o Ramper Marketing, envolvendo a criação do webhook, a definição do gatilho e a configuração dos campos obrigatórios e personalizados.
O que é um webhook?
Pense no webhook como um mensageiro instantâneo: ele envia informações de uma ferramenta para outra (por exemplo, do Ramper Pipeline para o Ramper Marketing) de forma quase imediata, assim que um evento específico (o "gatilho") acontece. Isso mantém a sua base de contatos sempre atualizada com os dados do funil de vendas.
Gatilhos que podem ser utilizados
Oportunidade foi adicionada: o lead é enviado assim que uma nova oportunidade é criada em qualquer funil e etapa.
Oportunidade foi editada: o lead é enviado sempre que uma oportunidade é alterada.
Oportunidade trocou de etapa: o lead é enviado quando avança ou retrocede para uma nova etapa.
Oportunidade entrou na etapa definida: o lead é enviado apenas quando entra em uma etapa específica que você definir.
Tarefa foi adicionada, editada ou concluída: o lead é enviado quando uma das tarefas selecionadas é executada.
Criando um novo webhook no Pipeline
Importante: se você trabalha com oportunidades do tipo "Organização" e "Pessoas", será necessário criar webhooks separados para cada entidade.
Acessando as Integrações e adicionando o webhook
Acesse a sua conta do Pipeline, clique em Gerenciar > Integrações e localize o bloco API Webhooks Pipeline. Clique em Adicionar/Editar.
Na lista de webhooks cadastrados, clique em Adicionar webhook.
Definindo os dados principais
Selecione o Gatilho do Webhook que irá ativá-lo (ex.: "Oportunidade entrou na etapa definida").
Se escolher esse gatilho, defina a Etapa da venda que o acionará (ex.: etapa "Perdido").
Defina um Título objetivo (ex.: "Enviar oportunidade de Organização para o Ramper Marketing").
No campo URL de destino, insira:
https://app.lahar.com.br/api/conversions
Configurando os campos avançados
A configuração dos campos do Pipeline é feita no próprio Ramper Pipeline; todos os campos nativos e adicionais criados estarão disponíveis em uma lista suspensa no menu de configurações do webhook.
No Ramper Marketing é possível integrar campos nativos e personalizados. Use exatamente a mesma nomenclatura dos campos nativos abaixo:
email_contato
nome_contato
sobrenome
nome_empresa
cargo
site_empresa
site_contato
setor
tel_fixo
tel_empresa
tel_celular
email_empresa
anotacoes
tags
twitter
facebook
facebook_empresa
linkedin
cidade
estado
endereco_empresa
dtaniversario
sexo
motivo_perda
token_api_lahar
nome_formulario
Para vincular um campo personalizado, insira o token do campo. Para localizá-lo: no menu do Ramper Marketing, vá em Geração de Leads > Campos Personalizados, clique em Ações > Editar no campo desejado e copie o Token exibido.
Configuração na plataforma:
Configure o formato de envio como POST.
Clique em Exibir: Configurar Campos para definir os campos enviados.
Clique em Incluir: Campo do Sistema para campos do Pipeline, ou Incluir: Campo manual (texto) para informações fixas.
Configure os nomes: na coluna Enviar com o nome (esquerda), digite o nome do campo do Ramper Marketing; na coluna Usar o campo (direita), selecione o campo correspondente do Pipeline ou digite o valor manual.
Campos obrigatórios em todo webhook:
email_contato: o e-mail do lead, chave primária de identificação no Ramper Marketing.
token_api_lahar: token único que identifica a sua conta.
nome_formulario: nome da conversão que aparecerá no histórico do contato (ex.: "pipeline-perdida-organizacao"). Limite de 100 caracteres.
Você também pode adicionar campos extras conforme a necessidade, como nome do contato, nome da empresa, tags, CNPJ (campo personalizado), entre outros.
Salvando e ativando o webhook
Marque a opção Enviar apenas as informações configuradas acima e clique em Salvar para ativar o webhook. Pronto! Ele será exibido na sua "Lista de Webhooks Cadastrados".