# Resolução de problemas

> Resolver problemas do DataFirefly Server-Side: nada chega, erros 401, webhook Shopify desaparecido, duplicados no GA4, conversões Unassigned.

- Página original: https://server-side.datafirefly.com/pt/docs/troubleshooting.html
- Idioma: pt
- Atualizado em: 2026-09-01
- Editor: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/pt/

---

As causas reais das avarias, pela ordem em que se encontram. Comece sempre pelo botão « Diagnose my connection » da página do seu site.

## « Nada chega »

As três causas, por ordem de probabilidade:

1. **O consentimento.** Se a opção « Require consent » estiver ativa e o seu site não tiver banner CMP, ou se o visitante não tiver consentido, nenhum evento parte: é o comportamento esperado, não uma avaria. O indício que não engana: o botão **Send test event** funciona (ignora o consentimento) mas mais nada chega.
2. **O site nunca foi ativado.** Destinos não guardados, ou botão « Activate my tracking » nunca clicado: o módulo recebe 401.
3. **O tracking está desativado no módulo.** No PrestaShop e no Shopware, « Enable tracking » vem OFF por predefinição.

## Os erros 401

| Erro | Causa e solução |
| --- | --- |
| `unknown_tenant` | Site a aguardar ativação, ou Site ID errado |
| `invalid_signature` | O corpo foi recodificado entre a assinatura e o envio: assine exatamente os bytes enviados |
| `timestamp_out_of_window` | Timestamp em milissegundos em vez de segundos, ou relógio do servidor não sincronizado (NTP) |

## Depois de uma rotação da chave HMAC

A recolha fica cortada enquanto a nova chave não for colada no módulo. É intencional: a rotação serve precisamente para invalidar a chave antiga.

## Shopify

- **Webhook desaparecido**: eliminado pelo Shopify após cerca de 48 horas de falhas. Verifique o Site ID no URL, recrie o webhook.
- **Encomendas em duplicado**: um webhook « Order creation » subsiste ao lado do « Order payment ». Elimine-o.

## WordPress / WooCommerce

Depois de qualquer alteração de configuração, limpe a cache do site: caso contrário, o LiteSpeed Cache e as outras extensões de cache continuam a servir o JavaScript antigo.

## GA4

- **Compras em duplicado**: atualize o módulo (PrestaShop 1.8.0+, WooCommerce 2.8.0+, Shopware 1.9.0+). O GA4 só desduplica `purchase`, e apenas por `transaction_id`: as versões recentes já não enviam a compra do lado do navegador.
- **Conversões « Unassigned »**: os eventos enviados transportam o identificador de sessão e o referrer, o que liga as conversões ao seu canal. O histórico já registado pelo GA4 não é reclassificado: a correção vale para o tráfego futuro.

## « Delivered » mas pouca atribuição

Um evento entregue não é forçosamente atribuído: a atribuição depende da **qualidade de correspondência**. Enriqueça os dados de utilizador enviados: e-mail, telefone, IP e user agent, cookies `fbp` e `gclid`. Os módulos DataFirefly transmitem-nos automaticamente quando estão disponíveis e o consentimento o permite.

## Janelas de recuperação

Antes de enviar um evento para uma plataforma, a DataFirefly verifica a sua idade. A regra é a mesma para um evento em direto, para um evento repetido por um módulo e para um evento libertado após uma pausa de quota do plano gratuito.

- **Meta, ChatGPT Ads (OpenAI) e Microsoft Advertising**: 7 dias.
- **GA4**: nenhum limite do nosso lado. O GA4 aceita eventos mais antigos e atribui-lhes uma nova data; é uma escolha deliberada.
- **Google Ads, TikTok e Pinterest**: nenhum limite do nosso lado, a plataforma decide.

Um evento que ultrapassou a janela de um destino não é enviado para esse destino. O Inspector mostra-o como **Not sent: too late**: no momento do envio, o evento já era mais antigo do que a janela de aceitação dessa plataforma.

## A fila do módulo

Quando a loja não consegue contactar a DataFirefly, o módulo coloca os eventos em fila e repete o envio (veja os guias de [PrestaShop](https://server-side.datafirefly.com/pt/docs/prestashop.html), [WooCommerce](https://server-side.datafirefly.com/pt/docs/woocommerce.html) e [Shopware](https://server-side.datafirefly.com/pt/docs/shopware.html)). A página do seu site na área de cliente mostra esta fila: eventos em espera, idade do mais antigo e hora do último relatório do módulo.

| Estado | Significado |
| --- | --- |
| Ainda sem relatório | O módulo ainda não comunicou nada. As versões anteriores a PrestaShop 1.29.0, WooCommerce 2.30.0 e Shopware 1.23.0 ficam neste estado: atualize o módulo para ver a fila. |
| OK | Nada a assinalar. |
| Atrasado | O evento mais antigo está em espera há mais de uma hora. |
| Silencioso | Havia eventos em espera e o módulo não envia nenhum relatório há 2 horas. |

Quando a fila precisa de atenção, recebe um e-mail, no máximo um a cada 24 horas. Se muitos sites ficarem atrasados ao mesmo tempo, o incidente está provavelmente do lado da DataFirefly: os e-mails aos clientes ficam retidos e só a nossa equipa de operações é alertada.

## Continua bloqueado?

Escreva-nos: [support@datafirefly.com](https://server-side.datafirefly.com/pt/contact.html), anexando o resultado do botão « Diagnose my connection ». Respondemos no prazo de um dia útil.

Atualizado: 1 de setembro de 2026
