Artigos sobre: API e Integrações
Este artigo também está disponível em:

Perguntas frequentes e erros comuns ao usar a API

Tira dúvidas sobre o uso da API com ferramentas externas


Usas ferramentas como n8n, Make, Zapier ou Postman para agendar publicações ou automatizar tarefas com a API da Metricool? Aqui respondemos às perguntas mais frequentes e aos erros mais comuns.


❓ Perguntas frequentes


Onde devo colocar o token de autenticação?


Em todos os casos, o token da tua conta Metricool deve ser enviado no cabeçalho:


X-Mc-Auth: O TEU API TOKEN


Também é obrigatório incluir:

Content-Type: application/json


⚠️ Verifica que o pedido inclui sempre os parâmetros blogId e userId.


📋 Tabela resumo por ferramenta


Ferramenta

Onde colocar o token (X-Mc-Auth)

Content-Type obrigatório?

Dicas úteis

n8n

Nas credenciais: Header Auth

application/json

Usa “Generic Credential Type” + “Header Auth”. Podes reutilizá-lo entre nós.

Make

No módulo HTTP: secção Headers

application/json

Usa módulos personalizados ou o oficial da Metricool.

Zapier

Em “Webhooks by Zapier”: secção Headers

application/json

Adiciona o cabeçalho na configuração avançada do Webhook.

Postman

No separador Headers do pedido

application/json

Ideal para testar pedidos manualmente.



Como posso obter o meu blogId?


Tens duas formas:


  1. A partir da URL da Metricool

Quando acedes a uma marca na tua conta, vais ver um URL como este.

Deves copiar o número que aparece depois de blogId, que identifica a marca.

(O número depois de userId identifica a tua conta.)


https://app.metricool.com/evolution/web?blogId=00000&userId=0000000


  1. Via API:

Faz um pedido a este endpoint. Ele devolve uma lista com todas as marcas que geres ou que foram partilhadas contigo, cada uma com o respetivo blogId:


https://app.metricool.com/api/admin/simpleProfiles?userId=O_TEU_USER_ID



Que formato deve ter a data de publicação (publicationDate)?


Deve seguir o formato ISO 8601, incluindo o fuso horário. Exemplo:

"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Lisbon"
}



Posso carregar imagens ou vídeos através da API?


Sim. Primeiro, tens de carregar o ficheiro na Metricool com o endpoint correspondente, obter o mediaId e referenciá-lo no teu post.

Certifica-te de que o link é público e não expira.

Recomendamos também fazer um pedido ao endpoint normalize, que garante que o ficheiro seja armazenado nos servidores da Metricool.


Posso usar a API com outras ferramentas?


Sim. Qualquer ferramenta que permita fazer pedidos HTTP com cabeçalhos personalizados pode ser integrada com a API da Metricool.


💡 Dica: Usa os endpoints dinâmicos para criar os teus pedidos. Consulta aqui a documentação técnica e o guia de uso.


⚠️ Erros comuns (e como resolvê-los)


Acesso negado (ou semelhante)


Este erro indica que o token não foi enviado corretamente ou não tem acesso à marca (blog).


✅ Solução:

  • Verifica se estás a usar o token correto da tua conta Metricool.
  • Confirma que está colocado como indicado na tabela.
  • Garante que o blogId e userId pertencem à tua conta.

🔎 Exemplo n8n:



A publicação é agendada mas não tem imagem ou vídeo


Isto acontece quando os ficheiros multimédia não foram tratados corretamente antes de enviar o pedido.


✅ Solução:

  1. Verifica que o link é público e não expira.
  2. Confirma que o mediaId está incluído no corpo do post.
  3. Antes de chamares https://app.metricool.com/api/v2/scheduler/posts, normaliza o URL do ficheiro:


https://app.metricool.com/api/actions/normalize/image/url?url=<URL_DO_FICHEIRO>


  1. Depois, usa o mediaId devolvido no teu post:
"media": {
"mediaId": "ID_DO_MEDIA"
}


Actualizado em: 30/07/2025

Esse artigo foi útil?

Partilhe o seu feedback

Cancelar

Obrigado!