> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Airtable

> Gerencie as contas de redes sociais dos seus usuários pelo Airtable

## Visão Geral

O [Airtable](https://www.airtable.com) é uma plataforma versátil baseada em nuvem que combina perfeitamente a estrutura de uma planilha com as robustas capacidades de um banco de dados.

Ao integrar os scripts de automação do Airtable — escritos em JavaScript — com a API da Ayrshare, você pode simplificar o gerenciamento das suas redes sociais diretamente no Airtable. Essa integração permite publicar conteúdo, analisar métricas de desempenho e gerenciar comentários em nome dos seus usuários, tudo em um único local centralizado.

Neste guia, apresentaremos as etapas para configurar a integração.

## Configuração

<Warning>
  Executar Scripts de Automação do Airtable requer um plano [pago](https://airtable.com/pricing) do Airtable.
  Certifique-se de que seu plano do Airtable inclua automações com scripts.
</Warning>

Este guia mostra como publicar automaticamente em contas de redes sociais vinculadas no Airtable via [Ayrshare](https://www.ayrshare.com).
Você pode publicar nas contas sociais de uma única empresa ou nas contas de redes sociais dos clientes que você gerencia. Todo o código abaixo pode ser encontrado no [GitHub](https://github.com/ayrshare/airtable-post-social-media/blob/main/script.js).

<Card horizontal icon="github" href="https://github.com/ayrshare/airtable-post-social-media/blob/main/script.js" title="GitHub: Airtable Post Social Media" />

## Obtenha Sua API Key

Comece obtendo sua API Key do plano gratuito ou pago no [Ayrshare Dashboard](https://www.ayrshare.com). A chave será usada no script abaixo.

Se você estiver no [Plano Launch](/multiple-users/business-launch-overview) ou no [Plano Business](https://www.ayrshare.com/business-plan-for-multiple-users/) da Ayrshare e quiser publicar em nome dos seus clientes, obtenha todas as Profile Keys dos seus clientes por meio dos endpoints /user ou /create-profile, ou no Dashboard Ayrshare.

<Tip>
  Certifique-se de ter vinculado algumas contas sociais na Ayrshare. Verifique na [página de vinculação
  social da Ayrshare](https://app.ayrshare.com/social-accounts).
</Tip>

## Crie um Workspace no Airtable

No [Airtable](https://www.airtable.com), crie um novo workspace com os campos. Certifique-se de nomear as colunas conforme abaixo:

<ul class="custom-bullets">
  <li>`Post` como Long Text</li>

  <li>
    `Platforms` como Multi Select com tipos: facebook, instagram, twitter, linkedin, reddit e
    telegram
  </li>

  <li>`Images` como Attachment</li>
  <li>`Profile Keys` como Single Line Text</li>
  <li>`Status` como Single Line Text.</li>
  <li>`Schedule Date` como Date com Local Format, Include Time Field e Time Format 24 Hours</li>
</ul>

<img class="center" src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/airtable-example.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=ac8b91e08f67f7c2432ddfbbf7e65aa0" alt="Exemplo de Tabela do Airtable" width="1536" height="161" data-path="images/packages-guides/airtable-example.webp" />

Esses campos serão usados no script de automação do Airtable que estamos prestes a criar.

Veja um [exemplo ao vivo no Airtable](https://airtable.com/shrCWY0oA1ghB42tI/tblpnTEiPwyuViqBo).

<Card horizontal icon="book-open" href="https://airtable.com/shrCWY0oA1ghB42tI/tblpnTEiPwyuViqBo" title="Exemplo de Redes Sociais no Airtable">
  Veja um exemplo ao vivo no Airtable
</Card>

## Insira Dados de Teste para a Publicação

Precisamos de alguns dados de exemplo para testar a publicação. Aqui está uma sugestão:

<ul class="custom-bullets">
  <li>`Post`: Insira *Feliz Ano Novo 2025* </li>

  <li>
    `Platforms`: selecione uma ou mais redes que você tenha vinculado. Certifique-se de que o nome esteja em minúsculas.
  </li>

  <li>
    `Images`: Anexe uma imagem. Sugerimos esta que você pode baixar e anexar:
    [https://img.ayrshare.com/012/gb.jpg](https://img.ayrshare.com/012/gb.jpg)
  </li>

  <li>
    `Profile Keys`: Se você estiver no Plano Business ou Plano Launch e quiser publicar no perfil de um cliente, insira
    a Profile Key dele. *Caso contrário, deixe em branco.*
  </li>

  <li>
    `Status`: Insira *pending*. O script só captura registros definidos como pending. Certifique-se
    de que "`pending`" esteja em minúsculas.
  </li>

  <li>
    `Schedule Date`: Deixe em branco, pois faremos apenas um teste de publicação imediata agora. Depois você pode
    selecionar uma data futura para agendar o post.
  </li>
</ul>

## Crie um Script de Automação com o Editor de Scripts

Agora vamos criar o script de automação do Airtable que lê os dados da sua tabela, cria um post e o envia para as redes sociais via Ayrshare. Você usará o editor de scripts do Airtable.

### Adicione um Trigger

* No workspace, clique em *Automation* e depois em *+New automation.*

<img class="center" src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/new%20automation.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=d2637323e3e540d6e46cf0d45e2f161a" alt="Vá para a seção Automation do Airtable" width="932" height="144" data-path="images/packages-guides/new automation.webp" />

<ul class="custom-bullets">
  <li>Nomeie a automação.</li>
  <li>Clique em *Choose a Trigger*.</li>
  <li>Selecione When a Record is Created.</li>
  <li>Selecione a tabela com os campos acima.</li>
  <li>Clique em Done.</li>
</ul>

## Adicione uma Ação

<ul class="custom-bullets">
  <li>Comece clicando em *Add Action*.</li>
  <li>Selecione *Run Script*. Você será levado para o editor de scripts.</li>
</ul>

**Delete** a linha:

```javascript theme={"system"}
console.log(`Hello, ${base.name}!`);
```

E **copie e cole** no editor de scripts o código a seguir:

```javascript theme={"system"}
const API_KEY = "Your API Key"; // Get a free key at app.ayrshare.com

console.log(`Starting Post ${base.name}!`);

const sendPost = async (data) => {
  const { post, platforms, imageUrls, profileKeys, scheduleDate, shortenLinks } = data;

  const body = Object.assign(
    {},
    post && { post },
    platforms && { platforms },
    profileKeys && { profileKeys: profileKeys.split(",") },
    Array.isArray(imageUrls) &&
      imageUrls.length > 0 && {
        mediaUrls: imageUrls.map((image) => image.url)
      },
    scheduleDate && { scheduleDate },
    shortenLinks !== undefined && shortenLinks !== null && { shortenLinks }
  );

  console.log("Posting JSON:", JSON.stringify(body, null, 2));

  if (profileKeys) {
    body.profileKeys = profileKeys.split(",");
  }

  const response = await fetch("https://api.ayrshare.com/api/post", {
    method: "POST",
    body: JSON.stringify(body),
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${API_KEY}`
    }
  }).then((res) => res.json());

  return response;
};

const table = base.getTable("Posts");
const query = await table.selectRecordsAsync();
const filteredRecords = query.records.filter((record) => {
  const status = record.getCellValue("Status");
  return status === "pending";
});

for (let record of filteredRecords) {
  const post = record.getCellValue("Post");
  const images = record.getCellValue("Images");
  const platforms = record.getCellValue("Platforms");
  const profileKeys = record.getCellValue("Profile Keys");
  const scheduleDate = record.getCellValue("Schedule Date");

  const shortenLinks = false;
  const response = await sendPost({
    post,
    platforms: platforms.map((x) => x.name),
    imageUrls: images,
    profileKeys,
    scheduleDate,
    shortenLinks
  });

  console.log(response);

  if (response) {
    let status;
    if (Array.isArray(response)) {
      status = response.map((x) => x.status).every((x) => x === "success") ? "success" : "error";
    } else {
      status = response.status;
    }

    await table.updateRecordAsync(record, {
      Status: status
    });
  }
}
```

Este código lerá da sua tabela e fará a publicação na Ayrshare. No entanto, primeiro você precisa adicionar sua API Key (obtida acima).

Substitua `Your API Key` pela sua API key real.

## Teste o Script

No editor de scripts, pressione *>Test*

O script será executado e exibirá a resposta da chamada da API. Se tudo funcionou, você verá uma mensagem de sucesso retornada, o campo pending nos seus registros mudará para success e seu post aparecerá na rede social selecionada.

Depois que você criar um novo registro na tabela, o script será executado e processará os registros pendentes.

## Documentação do Airtable

Se você quiser mais informações, consulte a [documentação do Airtable](https://www.airtable.com/developers).
Eles têm detalhes sobre como usar o editor de scripts do Airtable.

## Tutorial em Vídeo

Aqui está um ótimo tutorial em vídeo da equipe da Automate All The Things. Este vídeo mostra como integrar a Ayrshare em um projeto Airtable ao vivo.

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/U_jo6f5hsyY" title="Post To Social Media From Airtable" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" />
</div>

Veja mais [exemplos de integração do Airtable com redes sociais](https://www.ayrshare.com/blog/automatically-post-to-social-media-from-airtable/).

## Dúvidas

Se você tiver alguma dúvida ou comentário, entre em contato conosco por [e-mail](mailto:contact@ayrshare.com) ou <a href="javascript:void(0)" onClick={() => window.Intercom && window.Intercom('show')}>converse conosco</a>.