> ## 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.

# Notion

> Integre a API Ayrshare ao seu app Notion para gerenciar as contas de redes sociais dos seus usuários

## Visão Geral

O [Notion](https://notion.so) é um app de workspace que combina anotações, gerenciamento de projetos, wikis e um banco de dados personalizável em uma interface GUI.

A partir do Notion, você pode construir uma interface para gerenciar as contas de redes sociais dos seus usuários com a API de redes sociais da Ayrshare, permitindo publicar, obter análises e gerenciar comentários.

## Tutorial

Um tutorial em vídeo sobre como publicar em suas redes sociais diretamente do Notion.
Veja também nosso [guia passo a passo da API Notion](https://www.ayrshare.com/blog/schedule-social-media-posts-from-notion/).

<div class="video-container">
  <iframe width="560" height="315" src="https://www.youtube.com/embed/OeGGiG7SmVY" title="Notion Social Posting Integration" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</div>

Código no Github da integração de publicação social no Notion:

<Card title="GitHub: Integração Ayrshare com Notion" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  Publique em suas redes sociais diretamente do Notion
</Card>

### Criar um Banco de Dados no Notion

No Notion, crie um banco de dados em modo tabela com os seguintes nomes e tipos de coluna:

<ul class="custom-bullets">
  <li>`Post` como tipo *coluna Title* (você não tem escolha aqui quanto ao tipo de coluna)</li>

  <li>
    `Platforms` como tipo *coluna Multi Select* com valores: `facebook`, `instagram`, `twitter`,
    `linkedin`, `tiktok` e/ou `telegram`.
  </li>

  <li>`Images` como tipo *coluna Files & Media*.</li>
  <li>`Profile Keys` como tipo *coluna Text*.</li>
  <li>`Status` como tipo *coluna Text*.</li>

  <li>
    `Schedule Date` como tipo *coluna Date* com Date Format Month/Day/Year, Time Format 24 Hours e
    incluir hora
  </li>
</ul>

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/notion-db.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=b83093c27f4fae7e7d3d406eed353f63" alt="Exemplos de Banco de Dados Notion" width="1536" height="277" data-path="images/packages-guides/notion-db.webp" />

Esses campos serão usados no script especificado mais adiante nesta página. Observe que algumas redes sociais "platforms" exigem imagens ou vídeos. Por exemplo, o Instagram requer uma imagem ou vídeo e o TikTok requer um vídeo. Consulte os [endpoints](/apis/post/social-networks/facebook) das diferentes redes.

[Veja um exemplo ao vivo no Notion](https://ayrshare-example.notion.site/607c15ce7872456a879adbb0a5f17fdf?v=ee9f65a4afb24033813f245a45bc9e83)

### Insira os 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!"</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](https://img.ayrshare.com/012/gb.jpg) ou um vídeo.</li>
</ul>

<Info>**Você deve fazer upload de uma imagem para o Notion.** Você não pode usar uma URL de imagem.</Info>

<ul class="custom-bullets">
  <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>

### Criar Internal Integration no Notion

Vá para a [página My Integrations](https://www.notion.so/my-integrations) do Notion e clique em New Integration.

[Saiba mais sobre Notion Integrations](https://developers.notion.com/docs/getting-started#utilizing-notions-public-api-for-integrations).

Você pode nomear a integração como "Ayrshare" para identificá-la facilmente e escolher o workspace apropriado que terá os dados de post.

Por fim, as capacidades padrão que já foram selecionadas para você servirão. Submeta para criar a integração.

Se bem-sucedido, um token de integração interna estará disponível para você. Anote-o para as próximas etapas nesta página.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/create%20notion.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=48dce27786caad8a12c99f04f31a10d4" alt="Criar uma Integração Notion" width="1536" height="966" data-path="images/packages-guides/create notion.webp" />

E obtenha seu token de integração Notion.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/notion%20token.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=32b0f4d69eeabdc55409e801c6dbf9a7" alt="Obter um Notion Secret" width="512" height="253" data-path="images/packages-guides/notion token.webp" />

### Conectar o Banco de Dados Notion à Internal Integration

Abra o banco de dados Notion que você criou anteriormente. Clique no menu de reticências no canto superior direito da página e vá para **Add Connection**.

Aqui você pode buscar a internal integration que você criou na etapa anterior pelo nome escolhido.

Ao clicar na internal integration, você conectou este banco de dados do Notion à integração.

<img src="https://mintcdn.com/ayrshare-docs/6mPR4kmwNEz1kMbX/images/packages-guides/connect%20to%20ayrshare.webp?fit=max&auto=format&n=6mPR4kmwNEz1kMbX&q=85&s=318c31733bb8920c5d5765648f6cca80" alt="Conectar o Banco de Dados do Notion" width="1536" height="966" data-path="images/packages-guides/connect to ayrshare.webp" />

### Executar script para Enviar Posts do Notion

Você agora pode executar um script no seu ambiente local que lerá dados do banco de dados Notion e fará uma publicação por meio da API Ayrshare para cada linha com status "pending".

Certifique-se de definir as seguintes variáveis de ambiente usadas no script:

<ul class="custom-bullets">
  <li>
    `API_KEY`: esta é a `API Key` que você obtém da Ayrshare. Esta é a API Key primária do seu
    perfil primário Ayrshare.
  </li>

  <li>
    `NOTION_DATABASE_ID`: Abra o banco de dados que você criou anteriormente nesta página e obtenha o ID do banco de dados
    pela URL.
  </li>
</ul>

<Info>O ID do banco de dados será o valor antes de ?v= na URL da página do banco de dados.</Info>

```html theme={"system"}
https://www.notion.so/company/<NOTION_DATABASE_ID>?v=aaee9f</NOTION_DATABASE_ID>
```

<ul class="custom-bullets">
  <li>`NOTION_KEY`: token de internal integration obtido anteriormente.</li>
</ul>

Execute o seguinte JavaScript em um ambiente Node.js:

<ul class="custom-bullets">
  <li>Clone o repositório:</li>
</ul>

```bash theme={"system"}
git clone https://github.com/ayrshare/notion
```

<ul class="custom-bullets">
  <li>cd para o diretório **notion** e execute `npm install`.</li>

  <li>
    Atualize o arquivo `.env` com sua `API_KEY` da Ayrshare, `NOTION_KEY` do Notion e
    `NOTION_DATABASE_ID`.
  </li>

  <li>Execute `node index.js`</li>
</ul>

Você pode executá-lo no [Heroku](https://www.heroku.com/), [Digital Ocean](https://www.digitalocean.com/) ou [Vercel](https://vercel.com/) em produção.

Se bem-sucedido, todas as colunas com status `pending` serão alteradas para `success` e as publicações terão sido feitas nas redes sociais apropriadas.

<Card title="Github: Integração Ayrshare com Notion" icon="github" href="https://github.com/ayrshare/notion" horizontal>
  Publique em suas redes sociais diretamente do Notion
</Card>