Pular para o conteúdo principal

Notion

Disponível

Esta integração está ativa e pronta para uso no Frihet.

Conecte seu workspace do Notion ao Frihet. Busque páginas, consulte bancos de dados e acesse informações de projetos e clientes diretamente do seu ERP sem mudar de aplicativo.

Para que serve?​

Com o Notion integrado:

  • Buscar páginas — Encontre qualquer página do seu workspace a partir do Frihet
  • Listar bancos de dados — Veja todos os seus bancos de dados do Notion
  • Consultar registros — Faça consultas (queries) a bancos de dados com filtros
  • Contexto de projeto — Acesse informações de projetos vinculados a faturas
  • Documentação acessível — Consulte SOPs, contratos ou briefs sem sair do ERP

Requisitos​

  • Conta Notion ativa — notion.so
  • Internal Integration Token — É criado a partir das configurações de integrações do Notion
  • Frihet Pro ou superior

Conectar Notion com Frihet​

Passo 1: Criar uma integração interna no Notion​

  1. Vá para notion.so/my-integrations
  2. Faça login com sua conta do Notion
  3. Clique em New integration
  4. Configure a integração:
    • Name: "Frihet ERP"
    • Associated workspace: Selecione seu workspace
    • Capabilities: Marque pelo menos "Read content" e "Read user information"
  5. Clique em Submit
  6. Copie o Internal Integration Token (começa com ntn_...)
Guarde o token

O token pode ser consultado posteriormente, mas copie-o agora para não ter que voltar.

Passo 2: Compartilhar páginas com a integração​

O Notion exige que você compartilhe explicitamente as páginas ou bancos de dados com sua integração:

  1. Abra a página ou banco de dados que você quer que o Frihet possa ver
  2. Clique em ... (menu da página) → Connections
  3. Procure por "Frihet ERP" (o nome da sua integração)
  4. Clique para adicioná-la
  5. Repita para cada página ou banco de dados que você precisar
Apenas o que você compartilhar

A integração só pode acessar as páginas e bancos de dados que você compartilhar explicitamente. Ela não tem acesso a todo o seu workspace.

Passo 3: Configurar no Frihet​

  1. Vá para Ajustes → Integrações
  2. Procure por Notion
  3. Clique em Conectar
  4. Cole seu Internal Integration Token (ntn_...)
  5. Clique em Verificar conexão
  6. Se estiver correto, você verá o nome do seu workspace

Como funciona​

O Frihet usa a API do Notion (versão 2022-06-28):

  1. Você fornece seu Internal Integration Token
  2. O Frihet envia o token no cabeçalho Authorization: Bearer ntn_...
  3. Além disso, inclui o cabeçalho Notion-Version: 2022-06-28 em cada requisição
  4. As buscas e consultas são realizadas sob demanda
  5. O token é armazenado criptografado (AES-256-GCM) no Frihet

Dados sincronizados​

DadoDireçãoFrequência
Páginas (busca)Notion → FrihetSob demanda
Bancos de dados (listagem)Notion → FrihetSob demanda
Registros de banco de dadosNotion → FrihetSob demanda (query)
Propriedades de páginaNotion → FrihetA cada consulta

Funcionalidades​

Buscar páginas​

Busque qualquer página compartilhada com a integração por título ou conteúdo:

  1. A partir do Frihet, use a função de busca do Notion
  2. Digite o termo de busca
  3. O Frihet retorna as páginas que correspondem
  4. Clique em um resultado para ver os detalhes ou abrir no Notion

Listar bancos de dados​

Veja todos os bancos de dados compartilhados com a integração:

  1. O Frihet consulta todos os bancos de dados acessíveis
  2. Mostra nome, descrição e número de registros
  3. Selecione um para consultar seus registros

Consultar bancos de dados​

Faça consultas (queries) a um banco de dados com filtros:

  1. Selecione o banco de dados
  2. Aplique filtros (por propriedade, status, data, etc.)
  3. O Frihet exibe os registros que correspondem
  4. Útil para consultar, por exemplo, um banco de dados de clientes ou projetos

Importar contatos​

Você pode importar contatos de qualquer banco de dados do Notion:

  1. Conecte sua conta do Notion
  2. Selecione o banco de dados que contém seus contatos
  3. O Frihet detecta automaticamente os campos: nome, e-mail, endereço e identificação fiscal
  4. Os contatos são importados como clientes no Frihet
  5. Os duplicados são detectados por nome (não são importados duas vezes)

O Frihet busca campos com nomes como "Name", "Email", "Address", "Tax ID", "NIF" tanto em inglês quanto em espanhol.

Casos de uso​

Banco de dados de clientes no Notion​

Você mantém um banco de dados de clientes no Notion com campos como empresa, contato e notas. Do Frihet, você consulta esse banco de dados para obter contexto ao criar uma fatura.

Documentação de projetos​

Você tem a documentação de cada projeto no Notion (briefs, contratos, escopo). Ao faturar um projeto, você consulta a página do Notion diretamente do Frihet para verificar o escopo acordado.

CRM leve​

Você usa o Notion como um CRM informal com um banco de dados de deals. Do Frihet, você consulta o status de cada deal para saber quando é o momento de enviar uma fatura.

Solução de problemas​

"Erro de autenticação"​

  • Verifique se o token está correto e começa com ntn_
  • Verifique se a integração não foi desativada no Notion
  • Se você regenerou o token, atualize-o no Frihet

"Não encontro minhas páginas"​

  • A integração só vê as páginas que você compartilha explicitamente com ela
  • Abra a página no Notion → ... → Connections → Adicione sua integração
  • As páginas filhas de uma página compartilhada são acessíveis automaticamente

"Não consigo acessar um banco de dados"​

  • Compartilhe o banco de dados com a integração (mesmo processo que com páginas)
  • Verifique se a integração tem a capacidade "Read content" ativada

"Os dados estão desatualizados"​

  • As consultas ao Notion são em tempo real (sob demanda)
  • Se você não vir mudanças recentes, recarregue a visualização no Frihet
  • O Notion pode levar alguns segundos para refletir mudanças muito recentes

"Quero desconectar"​

  1. Vá para Ajustes → Integrações → Notion
  2. Clique em Desconectar
  3. Opcionalmente, desative ou exclua a integração em notion.so/my-integrations

Próximos passos​