Integração com Praedium CRM via webhooks
O CRM da Praedium é uma ferramenta utilizada para gerenciar leads e organizar o funil de vendas de forma eficiente. Neste artigo, você vai aprender como integrar o seu formulário do Respondi com a Praedium CRM via webhooks, permitindo a criação automática de novos contatos a cada resposta recebida no formulário.
No tutorial abaixo você vai aprender a:
- Configurar seu webhook pela Praedium;
- Inserir o webhook no Respondi;
- Mapear os campos do formulário na Praedium;
Configure seu webhook na Praedium
Para iniciar o processo, faça login na sua conta Praedium e certifique-se de que o Plano Alta Performance está ativo na sua conta. Siga os passos abaixo:
- No canto superior direito da tela, clique em seu nome de usuário;
- No menu suspenso que será exibido, clique em Integrações;
- Acesse a aba Central de Conexões e clique em Ativar > Salvar;

- Preencha os campos de Nome e Descrição para identificar a conexão e clique em Salvar;
- Após salvar, clique em Configurar > Webhook de Entrada > +Configurar;
- Na página Webhook de entrada, copie a URL de recebimento que foi gerada;

Agora é necessário colar essa URL no Respondi, seguindo os passos abaixo:
Insira o link de webhook no Respondi
- Com o link de webhook copiado, acesse a aba de Opções do formulário desejado;
- Desça com o mouse até a parte de Integrações e clique em Configurar integrações;
- Ative a opção Webhooks e cole a URL de recebimento;
- Clique em Salvar;

- Acesse o link público do formulário integrado e faça o preenchimento completo das respostas;
- Esse envio é essencial, pois permite que a Praedium identifique os dados recebidos.

Por fim, faça o mapeamento dos campos para configurar a integração:
Faça o mapeamento dos campos da integração
Assim que o primeiro respondente for recebido, a Praedium exibirá os campos para configuração. Agora é só fazer o mapeamento dos dados recebidos via formulário com os campos do CRM:
- Na parte de Mapeamento dos campos, clique em Configurar;
- Na página que abrir, clique em + Adicione um campo a integração;
- Na coluna Campos recebidos, selecione o valor JSON correspondente ao campo desejado (exemplo:
$json.respondent.answers.Qual_e_o_seu_nome?); - Na coluna Praedium, selecione o campo correspondente. Os campos são divididos em Dados do contato, Campos customizados, etc.
- Quando finalizar, clique em Salvar;

⚠️ Para que um contato seja criado, é obrigatório mapear: Nome + (Telefone ou E-mail);
👉 Crie campos customizados na Praedium: Criando campos personalizados de contatos.
Confira se a integração foi feita com sucesso
- Certifique-se de que a opção Conexão ativa está habilitada na Praedium;
- Acesse o link público do formulário integrado e faça o preenchimento completo das respostas;
- Na Praedium, verifique se o Contato foi criado conforme a configuração realizada na integração;
- Se desejar, é possível acompanhar os envios na aba de Logs da Praedium;

Confira a documentação oficial da Praedium CRM: Como receber leads na Praedium com o Webhook de Entrada
Quando deseja ativar a integração?
Na aba de Opções do seu formulário, acessando a parte de Integrações, você pode escolher quando deseja ativar as integrações:
- Ativar somente em respostas completas;
- Ativar em respostas completas e recuperadas;

Se escolher a opção Ativar em respostas completas e recuperadas, mesmo que a pessoa não conclua o preenchimento completo do formulário, os dados serão enviados para a integração.
Mas lembre-se, envios completos são notificados em alguns segundos. Já as respostas recuperadas, serão notificadas após 1h do inicio do preenchimento.