Crawler de mídia da Meta bloqueado (Instagram / Threads)

​

Sintoma

{
  "status": "error",
  "errors": [{
    "action": "post",
    "code": 479,
    "retryAvailable": false,
    "message": "The social network could not fetch the media from this URL, even after Ayrshare re-hosted it on its own CDN (Instagram/Meta subcode 2207052). Ensure the file is publicly reachable by Meta's crawlers (facebookexternalhit / Facebot) — check your robots.txt and any WAF/bot rules — not only in a browser. Retrying the same URL will not help until hosting is fixed.",
    "details": "Media download has failed.: The media could not be fetched from the provided URI. Restricted by robots.txt (HTTP error code 403). Meta subcode 2207052.",
    "platform": "instagram",
    "status": "error"
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "errors": [{
    "action": "post",
    "code": 440,
    "retryAvailable": true,
    "message": "The social network could not ingest the media in time. This is usually transient (for example Meta subcode 2207032 'download too slow' or 2207003 'create media fail'). Retry the post.",
    "details": "Media download has failed.: Media download took too long / could not create media...",
    "platform": "instagram",
    "status": "error"
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "errors": [{
    "retryAvailable": true,
    "status": "error",
    "code": 138,
    "details": "Media download has failed.: The media could not be fetched from the provided URI. Video download failed with: HTTP error code 403. Restricted by robots.txt",
    "action": "post",
    "platform": "instagram",
    "message": "Instagram Error: Instagram cannot process your post at this time. Please try your post again."
  }],
  "postIds": [],
  "id": "..."
}

{
  "status": "error",
  "errors": [{
    "status": "error",
    "code": 379,
    "message": "Error posting to Threads.",
    "action": "post",
    "platform": "threads"
  }],
  "postIds": [],
  "id": "..."
}

​

Por que isso acontece

​

Correção: atualize seu robots.txt

​

Recomendado: permita a Meta explicitamente, mantenha outros abertos

User-agent: facebookexternalhit
Allow: /

User-agent: *
Allow: /

​

Avançado: restrinja apenas aos publicadores sociais

User-agent: facebookexternalhit
Allow: /

User-agent: Twitterbot
Allow: /

User-agent: LinkedInBot
Allow: /

User-agent: Pinterest
Allow: /

User-agent: *
Disallow: /

​

Verifique se a Meta consegue buscar sua URL

curl -v --compressed -H "Range: bytes=0-524288" -H "Connection: close" \
  -A "facebookexternalhit/1.1 (+http://www.facebook.com/externalhit_uatext.php)" \
  "$URL"

• Resposta saudável: HTTP 200 ou 206 com dados binários no corpo.
• Resposta bloqueada: HTTP 403 ou uma página de erro vazia/HTML.

​

Se isso não resolver

• Atraso de propagação de 24 horas — A Meta armazena em cache o robots.txt. Aguarde até 24 horas após fazer alterações antes de tentar novamente.
• Regras de WAF ou bot-fight — O Cloudflare Bot Fight Mode, grupos de regras gerenciadas de bots do AWS WAF e serviços semelhantes podem bloquear as faixas de IP do crawler da Meta mesmo que o robots.txt permita. Verifique os logs do seu WAF e adicione uma exceção para facebookexternalhit.
• Proteção contra hotlink / verificações de Referer — Alguns CDNs bloqueiam requisições de IPs de data centers ou sem um cabeçalho Referer válido. Coloque o crawler da Meta na lista de permitidos ou desative a proteção contra hotlink para caminhos de mídia.
• Expiração de URL assinada / presigned URL — Se sua URL de mídia tem um timestamp de expiração (comum em URLs presigned do S3), garanta que ela não expire antes que o crawler da Meta possa buscá-la. Para publicações agendadas, gere URLs que permaneçam válidas até bem depois do horário agendado.
• Hospedagem de mídia gerenciada — Se você usa um serviço como Cloudinary, Imgix, ou similar, onde não pode editar o robots.txt, verifique a documentação deles para uma configuração de allow-list do crawler da Meta/Facebook.

• O postId com falha da resposta de erro
• A saída do comando curl de verificação acima
• O conteúdo do seu robots.txt

​

Tentar novamente uma publicação com falha

• Código 440 (transitório, retryAvailable: true): a ingestão simplesmente ficou sem tempo ou encontrou um erro temporário da Meta. Tente novamente diretamente usando o endpoint Retry Post; nenhuma alteração na sua hospedagem é necessária.
• Código 479 (retryAvailable: false): a Meta não conseguiu buscar a mídia mesmo depois que o Ayrshare a hospedou na sua própria CDN, então tentar novamente com a mesma URL bloqueada vai falhar de novo. Corrija a hospedagem primeiro: permita os crawlers da Meta (facebookexternalhit / Facebot) no robots.txt e no seu WAF, ou hospede a mídia em uma CDN que a Meta consiga acessar. Verifique com o comando curl acima e então tente novamente via o endpoint Retry Post.

​

Consulte também

• API do Instagram
• API do Threads
• Diretrizes de Mídia do Instagram
• Diretrizes de Mídia do Threads
• Códigos de erro do Ayrshare
• Falha na publicação de vídeo