Saltar para o conteúdo principal
Shopify

A mensagem «O URL webhook não está disponível» no Shopify para Odoo

Aparece quando o campo Webhook Url da loja Shopify está vazio e se tenta registar os webhooks: o módulo mostra O URL webhook não está disponível. Verifique o URL base do Odoo e o token webhook. (Webhook URL is not available. Check Odoo base URL and webhook token.) e o registo é interrompido. Aqui tens quando acontece, o que significa e o que verificar.

FlexigoTech · Responsável: Víctor Gómez · Atualizado em 5 de novembro de 2026

O essencial

Módulo
Shopify
Versões
Odoo 17, 18, 19 e 20
Verificado
no código do conector, versão 20.0 · nas fontes indicadas no fim
Leitura
5 min

Quando aparece exatamente

O módulo lança O URL webhook não está disponível. Verifique o URL base do Odoo e o token webhook. quando o campo Webhook Url da loja está vazio. É a primeira coisa que o registo de webhooks verifica: vem antes de analisar os temas de webhook e antes de consultar as subscrições que já existem no Shopify. Como o aviso interrompe a ação, o registo não avança enquanto o campo estiver vazio.

A mensagem existe no código publicado das ramificações do Odoo 17, 18, 19 e 20.

Esquema feito com código, não um ecrã do Odoo: o menu de lojas, os botões de registo e de execução, o campo do URL do webhook e a mensagem de erro
Esquema a partir do código publicado do módulo, não uma captura do Odoo: o caminho do menu, os botões de registar webhooks e de executar, o campo Webhook Url e a mensagem, com os rótulos em inglês do código. Vale para Odoo 17, 18, 19 e 20.
Your Odoo doesn't talk to Amazon, Temu or Shopify?
Vídeo: Your Odoo doesn't talk to Amazon, Temu or Shopify? (vídeo em inglês)

As duas portas por onde se chega

A mesma mensagem pode aparecer a partir de dois botões, porque ambos chegam ao método que regista os webhooks da loja:

  • Registar/atualizar webhooks (Register/Update Webhooks), na ficha da loja. Fica oculto quando o campo Shopify connection tem como valor a ligação do FlexigoTech Cloud; esse campo não se vê em nenhuma vista e esse é o seu valor por defeito, pelo que, com os valores por defeito, o botão não se vê. É igual no Odoo 17, 18, 19 e 20.
  • Executar (Run), no assistente Shopify Manual Sync. Este botão vê-se sempre.

A ficha da loja abre-se a partir do menu Shopify › Configuração › Lojas (Shopify › Configuration › Stores). Cada troço do menu exige uma permissão: Configuração (Configuration) exige Operador (Operator) e Shopify exige Visualizador (Viewer). Se não tiveres uma das duas, não vês esse troço. Dentro da ficha de Instâncias Shopify (Shopify Instances), o separador Webhooks mostra o campo Webhook Url, só de leitura.

Esquema feito com código, não um ecrã do Odoo, com a mesma mensagem em castelhano, alemão, francês, italiano e português
Esquema a partir das traduções publicadas do módulo, não uma captura do Odoo. Com o Odoo em português, a mensagem vê-se como O URL webhook não está disponível. Verifique o URL base do Odoo e o token webhook.

Um caso para o ver em ação

Exemplo Caso ilustrativo: a empresa e os seus dados são inventados para explicar o fluxo.

A Taller Norte é uma empresa inventada para este exemplo: vende cerâmica numa loja Shopify e a Marta, que trata da implementação do Odoo, está a deixar a ligação pronta. Abre o assistente Shopify Manual Sync e clica em Executar. Com o Odoo em português vê O URL webhook não está disponível. Verifique o URL base do Odoo e o token webhook. e o registo de webhooks é interrompido.

A Marta não procura uma falha de comunicação com o Shopify: o aviso depende de uma única condição, que o campo Webhook Url esteja vazio. Abre Shopify › Configuração › Lojas, entra na ficha da loja e olha para o separador Webhooks: de facto, está vazio. Como o campo é só de leitura, não tenta escrevê-lo. Volta ao que o próprio aviso nomeia, o URL base do Odoo e o token do webhook, e, quando Webhook Url já tiver valor, repete a ação. Com esse campo preenchido, esta verificação deixa de disparar.

O que faz o registo quando passa esta verificação

Isto não causa a mensagem, mas situa-te no que vem a seguir. Com Webhook Url preenchido, o registo lê os temas de webhook da loja, consulta no Shopify as subscrições que já existem, apaga as que apontam para esta base do Odoo e já não correspondem, e cria as que faltam. Se encontrar subscrições que apontam para endereços alheios a esta base do Odoo, deixa-as como estão e escreve uma nota na ficha da loja.

O que fazer, passo a passo

  1. Abre Shopify › Configuração › Lojas e entra na ficha da loja. Se não vês o menu ou algum dos seus troços, falta-te a permissão Operador ou Visualizador que cada um exige.
  2. Vai ao separador Webhooks e olha para o campo Webhook Url. Se estiver vazio, essa é a causa da mensagem.
  3. Não tentes escrever nele: é só de leitura. Revê o que diz a própria mensagem: o URL base do Odoo e o token do webhook.
  4. Quando Webhook Url tiver valor, repete a ação com Registar/atualizar webhooks (se o botão se vir na tua loja) ou com Executar no assistente Shopify Manual Sync.
  5. Confirma que esta mensagem já não aparece ao repetir a ação.

O que convém recordar do caso

  • A condição é uma só: Webhook Url vazio. Não depende de o Shopify responder, porque, dentro do registo de webhooks, esta verificação vem antes de qualquer consulta ao Shopify.
  • Um mesmo aviso, dois botões: se o vês ao clicar em Executar, a origem é a mesma que se o vires ao clicar no botão da ficha.
  • Com os valores por defeito, Registar/atualizar webhooks não se vê na ficha. Não o encontrares não significa que falte o módulo.
  • O aviso interrompe a ação: o registo não continua enquanto o campo estiver vazio.

Como ajuda a FlexigoTech

O módulo é de pagamento único por versão e precisa da subscrição do FlexigoTech Cloud (plano Conector, 49 €/mês ou 490 €/ano sem IVA). Está publicado para Odoo 17, 18, 19 e 20; com a subscrição, o módulo para as versões novas vem incluído se o compraste em flexigotech.com, e na Odoo App Store cada versão compra-se lá. Podes ver a ficha do Odoo Apps ou a página do módulo. Se estás a implementar o Odoo e queres que alguém reveja contigo a ligação ao Shopify, a FlexigoTech implementa Odoo 17, 18, 19 e 20 e desenvolve conectores e integrações à medida.

Continue a ler

A encomenda de venda … não está associada a uma encomenda do Shopify: o que fazerO que significa o erro «não está associada a uma encomenda do Shopify» no Odoo, quando surge com o botão Enviar para o Shopify e como verificá-lo passo a passo.Shopify no Odoo: o que fazer se lhe falta acesso OperatorO que significa o aviso de acesso Operator ou Manager do Shopify no Odoo, quando aparece ao enviar ou cancelar uma encomenda e como se resolve.O que faz o botão «Sincronizar pedidos» do Shopify Connector for Odoo, passo a passoO que faz o botão Sincronizar pedidos do conector Shopify para Odoo: quando aparece, o que verifica, o que muda na ficha e que erros pode dar.
Verificado no código do conector (versão 20.0) e nas fontes indicadas

Fontes