API do Facebook Page

​

Publicando no Facebook

{
  "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["facebook"]
}

• O Facebook mostrará automaticamente uma prévia do link na publicação, a menos que haja uma imagem ou vídeo incluído. No exemplo acima, a imagem será exibida. Remover a imagem fará com que a prévia do link seja mostrada.
• Se seu vídeo não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro isVideo. Consulte o endpoint /post para detalhes.
• O Facebook também suporta envio de mídia sem texto de publicação. Se você não quiser incluir texto na publicação, envie uma String vazia post: "".
• Consulte as Diretrizes de mídia do Facebook e a Autorização do Facebook para mais informações.

​

Imagens em carrossel

{
  "faceBookOptions": {
    "carousel": {
      // The URL of the "See More At" button - required
      "link": "URL of See More At...",
      "items": [
        // 2 min, 10 max elements in the array
        {
          "name": "Image name", // optional
          "link": "URL when image clicked", // required
          "picture": "URL of image" // required
        },
        {
          "name": "Image name",
          "link": "URL when image clicked",
          "picture": "URL of image"
        }
      ]
    }
  }
}

• O parâmetro link de nível superior é a URL no final do carrossel.
• O items é um array de objetos contendo os seguintes valores. Mínimo de 2 elementos e máximo de 10 elementos no array items.
• picture - URL da imagem do carrossel.
• link - URL para a qual o usuário é direcionado ao clicar na imagem.
• name - (opcional) Texto exibido em cada card de imagem.

​

Facebook Reels

{
  "post": "The description of the video",
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"],
  "faceBookOptions": {
    "reels": true,
    "title": "Super title for the Reel", // optional
    "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional
  }
}

• reels: Defina como true para publicar o vídeo em Reels. Obrigatório se você quiser publicar em Facebook Reels.
• title: O título do vídeo, com máximo de 255 caracteres. Textos com mais de 255 caracteres serão truncados. Opcional.
• thumbNail: A thumbnail (imagem de capa) do vídeo. A thumbnail deve ser uma URL para um arquivo JPEG ou PNG. A thumbnail deve ter menos de 10MB de tamanho. Opcional.

{
  "action": "post",
  "status": "error",
  "code": 108,
  "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ",
  "detailsData": {
    "id": "104619420979033_36930641143",
    "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook",
    "verifyReelsIn": "2024-01-26T00:07:05.170Z",
    "postUrl": "https://www.facebook.com/1046194209_36930641143",
    "reels": true
  },
  "retryAvailable": true,
  "platform": "facebook"
}

​

Facebook Stories

• Facebook Stories não suportam texto de publicação — qualquer texto fornecido no campo post, incluindo menções, será ignorado.
• Uma foto ou vídeo enviado para um story não pode ter sido usado em uma publicação anterior.
• Um story de vídeo não pode exceder 60 segundos.
• Ative o Stories Archive para conseguir fazer GET de stories.

{
  "post": "", // Ignored by stories
  "platforms": ["facebook"],
  "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"],
  "faceBookOptions": {
    "stories": true
  }
}

​

Legendas de mídia

{
  "faceBookOptions": {
    "mediaCaptions": ["This is my best pic", "😃 here is the next one"]
  }
}

​

Marcação de localização

// Using the Facebook Page Id - must be associated with a location
{
  "faceBookOptions": {
    "locationId": 7640348500 // Guggenheim Museum Page Id
  }
}

​

Segmentação de público

1. Facebook Targeting: Permite definir o público da sua publicação com base em fatores como idade, gênero, localização e status de relacionamento. Ao definir esses parâmetros, você garante que sua publicação seja exibida apenas para pessoas que atendem aos critérios especificados.
2. Facebook Feed Targeting: Esta opção permite refinar ainda mais a visibilidade da sua publicação nos News Feeds do seu público-alvo.

​

Targeting

• ageMin: Limita a idade mínima que pode ver as publicações. Valores aceitos: 13, 15, 18, 21 ou 25. Outras idades serão rejeitadas.
• countries: Também conhecido como geofencing, você pode limitar os países que podem ver a publicação. Array de códigos de país. O número máximo de países que podem ser segmentados é 25. Se precisar segmentar mais de 25 países, ou restringir certos países, consulte Restrições por país em Facebook Page.

{
    "faceBookOptions": {
        "targeting": {
            "ageMin": 18,
            "countries": ["DE", "BR"]
    }
}

​

Feed Targeting

• ageMin: Limita a idade mínima que pode ver as publicações. Valor inteiro 13 ou superior. Padrão é 0.
• ageMax: Limita a idade máxima que pode ver as publicações. Valor inteiro 65 ou inferior.
• countries: Também conhecido como geo targeting, você pode indicar os países que devem poder ver a publicação. Array de códigos de país.
• collegeYears: Segmenta a idade de graduação universitária para visualizar a publicação. Array de inteiros para ano de formatura na universidade.
• educationStatuses: Segmenta o status educacional para visualizar a publicação. Array de inteiros para segmentação baseada no nível educacional. Use 1 para ensino médio, 2 para graduação e 3 para ex-aluno.
• genders: Segmenta o gênero para visualizar a publicação. Array de inteiros para segmentação de gêneros específicos. 1 segmenta todos os visualizadores masculinos e 2 femininos. O padrão é segmentar ambos.
• relationshipStatuses: Segmenta o status de relacionamento para visualizar a publicação. Array de inteiros para segmentação baseada no status de relacionamento. Use 1 para solteiro, 2 para ‘em um relacionamento’, 3 para casado e 4 para noivo. O padrão inclui todos os tipos.

{
  "feedTargeting": {
    "ageMax": 30,
    "ageMin": 26,
    "countries": ["DE", "BR"],
    "genders": [1, 2],
    "relationshipStatuses": [1, 2]
  }
}

​

Texto alternativo

{
  "faceBookOptions": {
    // Array of Alt Texts
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}

​

Thumbnail de vídeo

{
  "faceBookOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}

​

Título de vídeo

{
  "faceBookOptions": {
    "title": "The best video ever!"
  }
}

​

GIFs animados

{
  "randomPost": true,
  "platforms": ["facebook"],
  // Set to true if the GIF URL does not end in .gif or .GIF
  "isVideo": false,
  // Only one URL is allowed in the array
  "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"]
}

​

Menções a Facebook Pages

​

Menção com nome de Page

{
  "post": "This is the best social media api by @Ayrshare"
}

​

Menção com Page ID

{
  "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID
}

​

Encontrar um Facebook Page ID

​

Endpoint Brand

​

No Facebook.com

1. Na Facebook News Feed, clique em Pages no menu lateral esquerdo.
2. Clique no nome da sua Page para ir até ela.
3. Clique em About no topo da sua Page. Se não vir, clique em More▼.
4. Role até encontrar seu Page ID abaixo de MORE INFO.

• Se a Facebook Page tiver uma URL como https://www.facebook.com/ayrshare-1234567890, então o ID é 1234567890.
• Se a Facebook Page tiver uma URL como:

​

Habilitar menções da Page

1. Visualizando como sua Page, clique na imagem de perfil da sua page no canto superior direito.
2. Clique em Settings & Privacy -> Settings.
3. No menu Settings, clique em Privacy.
4. Clique em Page and Tagging.
5. Role até Reviewing.
6. Alterne as configurações para permitir tags e menções.

​

Meta Business Suite

​

Publicações de rascunho

{
  "faceBookOptions": {
    "draft": true
  }
}

​

Horário de publicação agendada

{
  "faceBookOptions": {
    "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC
  }
}

​

Prévia de link

{
  "faceBookOptions": {
    "link": "https://www.ayrshare.com/instagram-hashtag-guide/"
  }
}

​

Facebook Ads

​

Limites de caracteres

​

Informações adicionais

​

Como adiciono quebras de linha ou rich text a uma publicação do Facebook?

​

Por que vejo “Published by Ayrshare” em uma publicação?