Erros Comuns durante a Integração iframe
1. Token do URL de Auto-Login White Label vs Token da API do Metricool
No Metricool, irás distinguir dois tipos de tokens:
O primeiro é adicionado como chave de acesso ao link autoin que usarás para criar o iframe na conta do teu cliente. Este token é individual e específico para cada uma das marcas que criares para a tua integração White Label. Aqui tens um exemplo da estrutura geral de um link de auto-login para criação de iframe:
https://app.metricool.com/autoin/[WL_TOKEN]?redirect=/planner
Podes recuperar este "Token White Label" indo ao menu > Definições da Marca > White Label e selecionando uma das duas URLs de acesso disponíveis. O token será único e mudará para cada uma das marcas que adicionaste. Também podes automatizar a criação do link de auto-login com o token de acesso realizando um pedido do tipo Get à nossa API (podes encontrar a documentação aqui). Aqui tens um exemplo:
https://app.metricool.com/api/admin/profile?blogId=&userId=&refreshBrandCache=false
O segundo token é a chave de acesso geral à nossa API para a tua conta Metricool, e não para a integração White Label. Este Token servir-te-á para integrar o Metricool com Looker Studio, Zapier, Make ou Canva, bem como com outras ferramentas que exijam uma ligação à nossa API, desde que sejam desenvolvidas por ti. Encontrá-lo-ás indo ao menu > Definições da Conta > API.
Se usares este último token como chave de acesso no link de auto-login, o iframe não será exibido no teu produto e aparecerá um erro de sintaxe na tua consola.

2. Erro: Referrer Policy; Content-Security-Policy: frame ancestor
Um erro comum está relacionado com as Políticas de Segurança de Conteúdo (CSP) sob o atributo "frame-ancestors". Este erro ocorre quando o teu servidor web tenta carregar uma página ou iframe que não é permitido pelas tuas políticas de segurança. Ao verificares a consola, encontrarás um erro deste tipo:

Para resolver isto, adiciona o atributo Referrer Policy ao teu iframe, antes da origem (src). Aqui tens um exemplo:
<iframe referrerpolicy="origin" src="https://app.metricool.com/autoin/xxxxxxxxxxx" …………></iframe>
3. Mistura de Sessões
Se mantiveres a conta principal do Metricool (aquela a partir da qual fizeste o pagamento) e a conta do teu produto onde inseres o teu iframe abertas no mesmo navegador, a informação de ambas pode misturar-se. Além disso, poderás encontrar erros de redirecionamento. Para evitar isto, garante que abres sempre as duas contas em navegadores diferentes, ou abre uma das duas numa janela de navegação privada (incógnito) no teu navegador de trabalho.
Recursos Adicionais
Actualizado em: 11/11/2025
Obrigado!
