Preparar a conexão com o Bling

Quem usa o Bling como ERP já tem lá os contatos e os vendedores. A integração mantém os dois lados conversando: como diz o topo da tela, contatos e vendedores sincronizados entre o Bling e a Prospectou.

A conexão pede uma preparação feita uma vez, nos dois sistemas: criar um aplicativo no Bling e trazer as credenciais dele para cá. É essa parte que este guia cobre, na ordem da tela.

Passo a passo

Passo 1 — Abra a tela do Bling

Entre no módulo Config. No menu lateral, abra Integrações e clique em Bling, o último item do grupo.

A tela tem três abas: Conexão, Vendedores e Sincronizações. Com a conexão Não configurado, só a primeira abre, e o bloco Conexão com o Bling mostra os quatro dados da conta (Empresa no Bling, Última sincronização, Acesso renovado até e Autorização expira em) em branco, com Conectar com o Bling e Testar conexão apagados.

Embaixo do bloco ficam os dois passos da preparação, numerados como na tela.

Passo 2 — Crie o aplicativo no Bling

Em developer.bling.com.br (o link está na tela), crie um aplicativo. Duas coisas dele vêm desta página:

O Link de redirecionamento, obrigatório no Bling. Copie o endereço com o botão ao lado do campo e cole como está. A tela avisa por quê:

é o mesmo endereço para todas as empresas: quem identifica a sua organização é um código assinado que viaja na autorização, não a URL;
qualquer diferença (uma barra a mais, http no lugar de https) faz o Bling recusar a conexão.

Os escopos, na seção Lista de escopos do aplicativo:

adicione Contatos e Vendedores;
inclua a permissão de escrita em Contatos se quiser que as alterações feitas aqui voltem para o Bling.

Faltando escopo, a tela avisa que a sincronização falha com "sem permissão" e mostra qual recurso foi recusado.

Passo 3 — Cole as credenciais

Do aplicativo criado no Bling, traga o Client ID e o Client Secret. Cole cada um no seu campo e clique em Salvar credenciais.

O Client Secret é guardado criptografado e nunca é exibido de volta: depois de salvo, ele não aparece mais nesta tela. Guarde-o onde a sua empresa guarda senhas.

Com as credenciais salvas, a ligação entre as duas contas é feita pelo botão Conectar com o Bling, no bloco do topo.

Resultado

O aplicativo do Bling sai com o endereço de retorno e as permissões que a integração usa, e as credenciais dele ficam guardadas na Prospectou, prontas para o Conectar com o Bling.

Dúvidas comuns

"O Bling recusou a conexão." Confira o Link de redirecionamento do aplicativo no Bling. Ele tem de ser exatamente o da tela: uma barra a mais ou http no lugar de https bastam para a recusa. Use o botão de copiar.

"A sincronização deu 'sem permissão'." Falta escopo no aplicativo do Bling. Confira se Contatos e Vendedores estão na Lista de escopos; a tela mostra qual recurso foi recusado.

"Onde vejo o Client Secret que salvei?" Em lugar nenhum desta tela: ele é guardado criptografado e não é exibido de volta.

"As abas Vendedores e Sincronizações não abrem." Na conexão Não configurado, só a aba Conexão abre.