Airtable

Sincronize suas tabelas do Airtable na base de conhecimento do AI SmartTalk. Transforme seus dados estruturados em conhecimento consultável por IA—perfeito para catálogos de produtos, FAQs, diretórios de equipe e muito mais.

---

Visão Geral

A integração do Airtable permite que você:

• Conecte sua base do Airtable via chave de API
• Sincronize dados da tabela como entradas da base de conhecimento
• Consulte seus dados de forma conversacional através da IA
• Mantenha os dados atualizados com sincronizações manuais ou programadas

---

Pré-requisitos

Antes de começar, certifique-se de que você possui:

• Uma conta ativa do AI SmartTalk
• Uma conta do Airtable com pelo menos uma base
• Uma chave de API do Airtable (Token de Acesso Pessoal)

---

Configuração Passo a Passo

Passo 1: Gere sua Chave de API do Airtable

1. Faça login na sua conta do Airtable
2. Vá para Configurações da Conta → Hub do Desenvolvedor
3. Clique em Criar novo token
4. Configure seu token:
   • Nome: Integração AI SmartTalk
   • Escopos: Selecione data.records:read e schema.bases:read
   • Acesso: Escolha as bases específicas que você deseja conectar
5. Clique em Criar token e copie-o imediatamente

Importante: Salve seu token com segurança—o Airtable o mostra apenas uma vez!

Passo 2: Conecte-se ao AI SmartTalk

1. Faça login na sua conta do AI SmartTalk
2. Navegue até Configurações → Integrações
3. Encontre Airtable e clique em Conectar
4. Cole sua chave de API no campo Token de Acesso Pessoal
5. Clique em Validar

Passo 3: Selecione Tabelas para Sincronizar

Após a validação, você verá suas bases e tabelas disponíveis:

1. Navegar bases: Clique para expandir cada base
2. Selecionar tabelas: Marque as tabelas que você deseja sincronizar
3. Configurar campos: Escolha quais colunas incluir
4. Clique em Iniciar Sincronização

Passo 4: Verifique a Importação

1. Vá para Conhecimento no AI SmartTalk
2. Seus registros do Airtable aparecem como entradas individuais de conhecimento
3. Teste sua IA fazendo perguntas sobre seus dados

---

O Que é Sincronizado

Tipo de Dado	Como é Processado
Campos de texto	Sincronizados como conteúdo pesquisável
Campos numéricos	Incluídos no contexto do registro
Seleção/Múltipla seleção	Tratados como categorias/tags
Registros vinculados	Referências incluídas
Anexos	URLs referenciadas (arquivos não baixados)
Fórmulas	Valores computados sincronizados

Exemplo: Catálogo de Produtos

Se você tiver uma tabela "Produtos":

Nome	Descrição	Preço	Categoria
Widget Pro	Widget de grau profissional...	$99	Ferramentas
Widget Lite	Widget de nível de entrada...	$49	Ferramentas

Sua IA pode responder:

• "Quais produtos você tem?"
• "Fale-me sobre o Widget Pro"
• "Qual é sua ferramenta mais barata?"

---

Configuração de Sincronização

Seleção de Campos

Para cada tabela, você pode configurar:

• Campo principal: Identificador principal para cada registro
• Campos de conteúdo: Campos a serem incluídos na base de conhecimento
• Campos a excluir: Campos internos a serem ignorados (IDs, timestamps, etc.)

Frequência de Sincronização

Opção	Descrição
Manual	Clique em "Sincronizar Agora" quando necessário
Na importação	Sincroniza quando você aciona uma importação
Agendado	Configurado via SmartFlow (veja abaixo)

Agendamento com SmartFlow

Para sincronizar automaticamente seus dados do Airtable:

1. Crie um novo SmartFlow
2. Adicione um gatilho Agendado (diário, semanal, etc.)
3. Adicione a ação Sincronizar → Selecione Airtable
4. Salve e ative o fluxo de trabalho

---

Casos de Uso

Catálogo de Produtos/Serviços

Sincronize seu banco de dados de produtos para que os clientes possam perguntar:

• "Quais produtos você tem abaixo de $100?"
• "Compare Widget Pro e Widget Lite"
• "Você tem algo na categoria Ferramentas?"

FAQ / Base de Conhecimento

Armazene FAQs no Airtable com colunas de Pergunta/Resposta:

• "Como faço para redefinir minha senha?"
• "Qual é a sua política de reembolso?"
• "Onde posso encontrar minha fatura?"

Diretório da Equipe

Sincronize os dados dos membros da equipe para consultas internas:

• "Quem cuida do suporte ao cliente?"
• "Qual é o papel da Sarah?"
• "Liste todos na equipe de Engenharia"

Dados de Eventos/Agenda

Sincronize tabelas de eventos para consultas de agendamento:

• "Quais eventos estão por vir?"
• "Quando é o próximo webinar?"
• "O que aconteceu no meetup do mês passado?"

---

Solução de Problemas

Problemas de Conexão

Problema	Solução
"Chave de API inválida"	Regenerar token no hub de desenvolvedores do Airtable
"Base não encontrada"	Certifique-se de que o token tem acesso a essa base
"Permissão negada"	Adicione o escopo data.records:read ao seu token

Problemas de Sincronização

Problema	Solução
Registros ausentes	Verifique se os registros não estão filtrados/ocultos na visualização
Dados desatualizados	Clique em Sincronizar Agora para atualizar
Campos errados sincronizando	Revise a seleção de campos nas configurações de integração

IA Não Consegue Encontrar Dados

Problema	Solução
Sem resultados para consultas	Aguarde a sincronização ser concluída e a IA processar
Respostas parciais	Certifique-se de que todos os campos relevantes estão incluídos na sincronização

---

Gerenciando a Conexão

Ação	Como
Atualizar chave de API	Configurações → Integrações → Airtable → Atualizar Token
Adicionar tabelas	Editar conexão → Selecionar tabelas adicionais
Remover tabelas	Desmarcar tabelas que você não deseja mais sincronizar
Desconectar	Configurações → Integrações → Airtable → Desconectar

---

Melhores Práticas

1. Estruturar para IA: Use nomes de campos claros e descritivos
2. Deduplicar dados: Remova registros duplicados antes de sincronizar
3. Usar campos principais sabiamente: Escolha identificadores únicos e descritivos
4. Sincronizações regulares: Mantenha os dados atualizados, especialmente para conteúdo em mudança
5. Limitar escopo: Sincronize apenas tabelas que sua IA precisa para responder perguntas

---

Documentação Relacionada

• Visão Geral de Integrações
• Gerenciamento da Base de Conhecimento
• Importação de URL CSV — Alternativa para dados estáticos
• Gatilhos Programados do SmartFlow — Automatizar sincronizações