As integrações via API do Pcontrol permitem cadastrar automaticamente as informações de novos leads diretamente na lista de oportunidades, otimizando o processo de prospecção e gestão comercial. Essa conexão possibilita que os dados coletados em outros sistemas ou formulários sejam enviados em tempo real para o Pcontrol, garantindo agilidade, precisão e centralização das informações. Com isso, a equipe de vendas pode atuar de forma mais organizada e estratégica, aproveitando melhor cada oportunidade gerada e aumentando as chances de conversão.

1 – Acessando a API escolha a opção Lista de Oportunidades na opção Encaminhar Para:

2 – Confira se a opção Lista de Oportunidades está selecionada. Em seguida clique em salvar.

3 – A Integração será salva e ela será listada na lista de integrações, atenção Código/Token gerado. Na coluna ações clique no botão detalhes, ícone de um olho.

4 – Veja o endpoint da API do Pcontrol e um código JSON de exemplo que você pode copiar e colar.

5 – Usando o Postman como plataforma de testes de API, acesse a aba Authorization e então na opção Auth Type, escolha Bearer Token.

  • Código/Token do Pcontrol é o Token que deverá ser enviado na requisição POST
  • Endpoint do Pcontrol é a URL que deverá ser usada para o envio da requisição à API do Pcontrol

6 – Cole o código JSON, no campo Body na opção RAW com JSON no tipo Text no Postman. 

Atenção: Na API de envio para a Lista de Oportunidades, o campo data_fechamento não deve ser preenchido.

 

7- Na requisição é também é possível enviar uma lista de produtos. Eles devem ser enviados em forma de array e devem ser enviados os códigos SKU dos produtos cadastrados no Pcontrol.

8 – Após enviar a requisição, o retorno deve ser um HTTP Status Code 200 com a mensagem “Dados enviados para fila de cadastro com sucesso”.

Atenção: O lead enviado na requisição cai em uma fila e será cadastrado no Pcontrol em alguns minutos. O cadastro não é instantâneo a partir do envio da requisição.

9 – Acessando a Lista de Oportunidades – Outros Leads no Pcontrol, clicando no menu superior Oportunidades e em seguida em Lista de Oportunidades e selecionando a opção Outros Leads.

10- O lead enviado é encontrado na lista, conforme a data e origem correspondentes.

 

Úteis:

Endpoint:

https://api.pctrlx.com.br/lead/cadastrar

Código JSON:

{
"nome": "Carlos Oliveira",
"cnpj": "23.456.789/0001-22",
"razao_social": "Oliveira Soluções Ltda.",
"nome_fantasia": "Oliveira Soluções",
"email": "carlos.oliveira@oliveirasolucoes.com.br",
"telefone": 1133557788,
"celular": 11998765432,
"cep": "09050020",
"endereco": "Rua São João",
"numero": "450",
"complemento": "Conjunto 201",
"bairro": "Centro",
"cidade": "Diadema",
"uf": "SP",
"observacao": "Cliente prefere contato por e-mail e atende das 09:00 às 17:00.",
"campos_personalizados": {
"total_funcionarios": 18,
"setor": "Serviços e Soluções"
}
}