Como fazer integração com sites e sistemas web ao CRM PipeRun, via JSON? Para integrar sistemas web, sites ou formulários em geral com o PipeRun, você poderá utilizar a função de integração via JSON. Esta enviará os dados desejados e, com eles, criará Oportunidades no CRM de Vendas.
O JSON (JavaScript Object Notation) é um formato de troca de dados simples entre sistemas, processo também conhecido como parsing. Temos um exemplo de código para fazer essa integração a seguir.
Se desejar, disponibilizamos uma explicação deste artigo em vídeo:
*Lembrando que também é necessário ter a ID do formulário a ser integrado, e que o código precisa ser adaptado à realidade da integração.
** A hash da etapa do funil pode ser obtida clicando em uma etapa do funil, dentro da área de ajustes - funis e etapas.
Informações gerais para envio:
- Endpoint: https://app.pipe.run/
webservice/integradorJson? hash=HASH_DA_ETAPA_DO_FUNIL - Tipo de requisição: POST
- Tipo de conteúdo (Content-Type): application/json
JSON de regras (envio não obrigatório):
JSON do lead (envio obrigatório):
Exemplo do JSON de regras e lead:
Pontos importantes:
- Caso o título não seja definido, o padrão "H:i d/m Integração: Name" será utilizado.
- Caso as Tags informadas não existam, elas serão criadas e vinculadas, automaticamente.
- Caso os campos customizados não existam, eles serão criados e vinculados automaticamente (serão campos do tipo "texto" por padrão. Para outros tipos de campos, o campo deverá ser criado previamente).
OBSERVAÇÃO: Campos customizados são espaços onde o cliente informará dados que julga importantes para o seu negócio e para suas vendas. São informações que farão a diferença na negociação, por exemplo, o WhatsApp do cliente, o número de CRECI do corretor, entre outros.
NOTA: Você poderá utilizar o atributo "id" para evitar a duplicidade de leads, utilizando o dado informado para ser único junto a oportunidade, dessa forma, antes de salvar, o piperun irá verificar se esse dado já existe vinculado a alguma oportunidade aberta, existindo o dado em uma oportunidade aberta, será apenas atualizada a oportunidade, caso contrário, uma nova oportunidade será criada. É possível ainda atualizar oportunidades com status diferente de aberto, como perdido, ou ganho utilizando o parâmetro "filter_status_update" nas rules. Também é possível atualizar oportunidades que estejam na situação de congelada ou na lixeira, utilizando o parâmetro "filter_situation_update".
Exemplo de código em funcionamento, em um formulário para testes (clique no "result" e preencha com seus dados para testar):
O PipeRun devolverá um JSON após realizar o cadastro:
Exemplos
Exemplo de código para captura de lead via integrador JSON com coleta de campanha através das variáveis UTM e conversão no Analytics.
Exemplo de código para captura de lead via integrador JSON com javascript puro, sem a necessidade de uso do jQuery.
Exemplo de código para captura de lead via integrador JSON implementado no Wordpress com Elementor.
Em caso de dúvida, entre em contato com nossa equipe de suporte.