> For the complete documentation index, see [llms.txt](https://ajuda.uplaces.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajuda.uplaces.com.br/integracoes/bling/webhook.md).

# Webhook do Bling: configurar e reativar

Webhook do Bling inativo por erros na operação? Veja onde fica o aplicativo no Bling, como reativar Produtos, Estoques e Pedidos e conferir na Uplaces.

O webhook é o que faz a loja receber sozinha, sem importar de novo, as mudanças feitas no Bling: preço, nome e foto dos produtos, saldo de estoque e situação dos pedidos. Ele é configurado dentro do Bling, no aplicativo da Uplaces, e cada recurso (**Produtos**, **Estoques**, **Pedidos de Vendas**) liga e desliga em separado.

{% hint style="warning" %}
**No Bling aparece "Webhook inativo por erros na operação"?** O Bling desligou aquele recurso. Siga os passos abaixo para reativar e, no fim, importe uma vez para trazer o que mudou enquanto ele estava desligado.
{% endhint %}

## Antes de começar

* O Bling conectado à Uplaces. Veja [Conectar o Bling](https://ajuda.uplaces.com.br/integracoes/bling/conectar.md).
* Acesso ao cadastro de aplicativos da sua conta do Bling.
* Na Uplaces, a tela do Bling aberta em **Integração ERP › Nativa**, para copiar o endereço do webhook.

{% stepper %}
{% step %}

## Abrir o aplicativo da Uplaces no Bling

1. No Bling, abra a Área do Integrador, no [cadastro de aplicativos](https://www.bling.com.br/cadastro.aplicativos.php#list). É o mesmo endereço do botão **abrir cadastro** da tela do Bling na Uplaces.
2. Clique no aplicativo da Uplaces e vá à aba **Webhooks**.

Não procure em **Central de Extensões › Minhas instalações**: ali o aplicativo aparece, mas não se edita. E não use **Desinstalar aplicativo**, que desconecta a Uplaces e para o envio de pedidos.
{% endstep %}

{% step %}

## Conferir o servidor

Em **Configuração de servidores**, deve haver uma linha com o nome que você deu (por exemplo, Uplaces) em **Alias** e, em **URL**, o endereço que a Uplaces mostra no rótulo **Endereço para receber os eventos (estoque, produtos e pedidos)**.

Se não houver, clique em **Adicionar servidor**, preencha **Alias** e cole a **URL** com o botão **Copiar** da tela da Uplaces.
{% endstep %}

{% step %}

## Ligar cada recurso

Em **Configuração de webhooks**, faça em **Produtos**, **Estoques** e **Pedidos de Vendas**:

1. Clique em **Detalhes** para abrir o recurso. O que está desligado por falha aparece em amarelo, com **Webhook inativo por erros na operação**.
2. Ligue **Webhook ativo**.
3. Em **Servidor**, escolha o servidor da Uplaces. Em **Versão**, escolha **v1**.
4. Marque todas as ações do recurso, como **Criação**, **Atualização** e **Exclusão**.

| Recurso no Bling      | O que chega à loja                                              |
| --------------------- | --------------------------------------------------------------- |
| **Produtos**          | preço, nome, foto e categoria dos produtos que já estão na loja |
| **Estoques**          | o saldo, a cada movimento de estoque                            |
| **Pedidos de Vendas** | a situação do pedido, conforme o **Mapeamento dos status**      |
| {% endstep %}         |                                                                 |

{% step %}

## Salvar

Clique em **Salvar webhooks**.
{% endstep %}

{% step %}

## Trazer o que ficou para trás

O Bling não reenvia o que mudou enquanto o webhook estava desligado. Na Uplaces, clique em **Importar do Bling** e escolha **Catálogo inteiro** para atualizar preço e estoque de uma vez. Veja [Importar produtos e clientes do Bling](https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md).
{% endstep %}

{% step %}

## Conferir na Uplaces

1. Na tela do Bling na Uplaces, aba **Webhooks**, confira se **Ativar recebimento via webhooks** está marcado. Desmarcado, a Uplaces ignora os avisos do Bling.
2. Mude o preço de um produto no Bling.
3. Abra o [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md), aba **Recebidos**, e procure `product.updated`. Para estoque, procure `stock`; para pedidos, `order.updated`.
   {% endstep %}
   {% endstepper %}

## Resultado

Os três recursos aparecem como **Webhook ativo** no Bling, e a mudança de preço, de estoque ou de situação chega à loja sem importar de novo. Produto novo continua entrando pelo **Importar do Bling**.

## Por que o Bling desliga o webhook

O Bling desliga um recurso quando os avisos dele falham por algum tempo seguido, e desliga só aquele recurso. Por isso é comum o estoque continuar chegando com **Produtos** desligado: a loja atualiza o saldo e não atualiza o preço. Quando isso acontece, o Bling marca o recurso com **Webhook inativo por erros na operação** e não religa sozinho.

## Problemas comuns

<details>

<summary>Não acho o aplicativo da Uplaces no Bling</summary>

Ele fica no [cadastro de aplicativos](https://www.bling.com.br/cadastro.aplicativos.php#list), não na Central de Extensões. Se não aparece lá, ele pode ter sido criado por outro usuário da sua conta do Bling (o contador ou o TI, por exemplo). Peça a essa pessoa.

</details>

<details>

<summary>Religuei e desligou de novo</summary>

Confira, nesta ordem:

1. A **URL** do servidor é exatamente a que a Uplaces mostra.
2. O **Client Secret** do aplicativo não foi gerado de novo no Bling. Se foi, a Uplaces recusa os avisos, e o Bling volta a desligar o webhook. Na tela do Bling na Uplaces, clique em **Ver credenciais do aplicativo**, cole o **Client Secret** novo e clique em **Salvar**.

Se os dois estiverem certos e o Bling desligar de novo, fale com o suporte da Uplaces.

</details>

<details>

<summary>O webhook está ativo e nada chega à loja</summary>

Na Uplaces, aba **Webhooks** da tela do Bling, marque **Ativar recebimento via webhooks** e clique em **Salvar**. Depois confira o [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md), aba **Recebidos**.

</details>

<details>

<summary>O aviso chega e o preço não muda</summary>

Na aba **Configurações** da tela do Bling na Uplaces, veja se **Não atualizar preço de tabela** está marcado em **Critérios para atualização de PRODUTOS**. Veja [Ajustes depois de conectar](https://ajuda.uplaces.com.br/integracoes/bling/conectar.md#ajustes-depois-de-conectar).

</details>

## Perguntas frequentes

<details>

<summary>Preciso do webhook para a integração funcionar?</summary>

Para o pedido ir da Uplaces ao Bling, não. Para preço, estoque e situação do pedido virem do Bling sozinhos, sim. Sem ele, essas mudanças só chegam quando você clica em **Importar do Bling**.

</details>

<details>

<summary>O webhook do Bling fica em Gatilhos (webhooks) da Uplaces?</summary>

Não. **Integração ERP › Gatilhos (webhooks)** faz o caminho contrário: avisa um sistema seu quando algo muda na loja. O webhook do Bling se configura no aplicativo, dentro do Bling.

</details>

<details>

<summary>Perdi pedidos enquanto o webhook estava desligado?</summary>

Não. O envio de pedidos da Uplaces ao Bling não depende do webhook. O que pode ter ficado para trás é a situação do pedido vinda do Bling: ela volta a ser atualizada na próxima mudança feita no Bling.

</details>

## Veja também

* [Integração com o Bling](https://ajuda.uplaces.com.br/integracoes/bling.md)
* [Conectar o Bling](https://ajuda.uplaces.com.br/integracoes/bling/conectar.md)
* [Importar produtos e clientes do Bling](https://ajuda.uplaces.com.br/integracoes/bling/importar-produtos-e-clientes.md)
* [Pedidos da Uplaces no Bling](https://ajuda.uplaces.com.br/integracoes/bling/pedidos.md)
* [Log de integração](https://ajuda.uplaces.com.br/integracoes/log-de-integracao.md)
