> ## Documentation Index > Fetch the complete documentation index at: https://docs.strattum.ai/llms.txt > Use this file to discover all available pages before exploring further. # MeetGeek > Reuniões e times do MeetGeek no Data Catalog e no Memory, e a transcrição e o resumo de cada reunião no Knowledge, visíveis para o anfitrião da reunião. O conector MeetGeek lê as reuniões gravadas no MeetGeek, os times da conta e, de cada reunião, a transcrição e o resumo com os highlights. Cada reunião e os documentos dela ficam visíveis para o anfitrião da reunião. | | | | - | - | | **Status** | Disponível | | **Conteúdo** | Registros e documentos | | **Autenticação** | Chave de API do usuário | | **Permissões** | Por item | | **Sincronização** | Incremental e full refresh, por recurso | | **Última revisão** | 26/10/2026 | ## Capacidades * Traz ao Data Catalog os metadados de cada reunião (título, anfitrião, participantes, início e fim, idioma, origem, template e evento de calendário) e os times da conta. * Publica cinco modelos limpos: `meetgeek_meetings`, `meetgeek_hosts`, `meetgeek_meeting_participants`, `meetgeek_meeting_teams` e `meetgeek_teams`, com datas em UTC e e-mails em minúsculas. * Alimenta o Memory pelo fragmento de ontologia do conector. As reuniões viram nós `Meeting` e os anfitriões viram nós `Agent`, ligados por "organizada por". Cada participante se liga à reunião por "participou de" quando o e-mail dele já existe no grafo, vindo de outro conector. A reunião entra na linha do tempo pela data de início. Os anfitriões se unem às pessoas do HubSpot, Jira, Zendesk e ClickUp pelo e-mail. Os nós só entram no grafo depois que a ontologia unificada é aplicada. * Envia ao Knowledge a transcrição e o resumo de cada reunião, como dois documentos de texto com o link da reunião no MeetGeek. * Grava a permissão de cada reunião e de cada documento a partir do anfitrião (ver Permissões). ## Recursos disponíveis | Recurso | O que contém | Carga | Cursor | Destino | Permissão por item | | - | - | - | - | - | - | | `meetings` | Uma linha por reunião, com `title`, `host_email`, `participant_emails`, `team_ids`, `language`, `source`, `timezone`, `template`, `event_id`, `timestamp_start_utc` e `timestamp_end_utc` | Incremental | Nenhum | Catálogo e Memory | Sim | | `teams` | Times da conta, com `name`, `can_view` e `can_share` | Full refresh | Nenhum | Catálogo | Não | | `transcripts` | Transcrição de cada reunião, uma fala por linha no formato `[hh:mm:ss] : ` | Incremental | Nenhum | Knowledge | Sim | | `summaries` | Resumo de cada reunião convertido de HTML para texto, os insights quando houver e os highlights, um por linha no formato `: ` | Incremental | Nenhum | Knowledge | Sim | Nenhum recurso tem cursor por data. A API do MeetGeek não filtra a listagem por data, e uma gravação enviada hoje pode ter data antiga. O conector guarda, por isso, a lista das reuniões já sincronizadas e o estado de cada documento delas (ver Como a sincronização funciona). Na criação pelo Console, os quatro recursos e as tabelas clean nascem ligados. `meetings` não pode ser desligado: a permissão dos documentos vem do anfitrião, que só aparece no detalhe da reunião. Você pode desligar `transcripts` ou `summaries` no Data Catalog para gastar menos requisições. A transcrição é a parte mais cara, com uma requisição por bloco de 500 falas. O link de cada documento é `https://app.meetgeek.ai/meeting/`, e o título é o título da reunião. O campo `join_link` da reunião nunca é gravado, porque pode conter a senha da sala. ### Como ler os dados * `external_id` de `meetgeek_meetings` é o `meeting_id` do MeetGeek. `started_at` e `ended_at` estão em UTC. `timezone` é o fuso da reunião, só informativo. * `meeting_source` é a origem da reunião no MeetGeek (convite de calendário, envio de arquivo). A coluna foi renomeada de `source` porque o Memory usa `source` para o nome do conector. * `event_id` é o id do evento de calendário. Fica NULL em reunião instantânea e em gravação enviada por arquivo. * `meetgeek_hosts` tem um anfitrião por linha. `external_id` e `email` trazem o mesmo e-mail, porque a API do MeetGeek não tem id de usuário. `phone` é sempre NULL. * `meetgeek_meeting_participants` tem uma linha por reunião e e-mail de participante, sem repetição. O anfitrião não entra nessa tabela, a não ser que o MeetGeek o liste também como participante. * `meetgeek_meeting_teams` tem uma linha por reunião e time com acesso a ela. `team_id` se liga a `meetgeek_teams.external_id`. * Duas pessoas gravando a mesma call geram duas reuniões, cada uma com o próprio `meeting_id` e o próprio anfitrião. As duas compartilham o `event_id` quando a call veio de um convite. ## Permissões (ACL) O conector lê a permissão de cada item na fonte e a guarda junto com o dado. Em **Comportamento dos dados**, você escolhe entre dois modos: | Modo | Quem vê | | - | - | | Aberto | Quem puder usar este conector vê todos os registros. As permissões da fonte são ignoradas. | | Espelhar a fonte | Cada pessoa vê apenas os registros que a própria fonte libera para ela. | No modo "Espelhar a fonte", a Strattum reconhece o anfitrião pelo e-mail dele no MeetGeek. O conector grava esse e-mail como uma identidade do MeetGeek, ligada a esta conexão, e assume que a pessoa usa o mesmo e-mail na Strattum. O MeetGeek não tem a opção **Exigir login na fonte como prova de identidade**. No passo de acesso do assistente de criação, o **Comportamento dos dados** começa em "Aberto". ### Como a fonte define acesso No MeetGeek, quem gravou a reunião é o dono dela. Ela pode ser compartilhada pelo convite de calendário, com uma pessoa específica, por link público ou por uma regra de time. A API informa o anfitrião, os e-mails dos participantes e os ids dos times com acesso a cada reunião. Ela não informa quem são os membros de cada time nem com quem a reunião foi compartilhada individualmente. ### Como a Strattum traduz o acesso | Item | Quem recebe acesso | | - | - | | `meetings` | O anfitrião da reunião | | `transcripts`, `summaries` | O anfitrião da reunião de que o documento faz parte | | `teams` | Todo mundo que pode usar o conector | Participantes e times não recebem acesso. Estar na call não é o mesmo que ter acesso à gravação no MeetGeek, e a API não lista os membros dos times. Um colega que vê a reunião no MeetGeek por um time ou por compartilhamento não a vê na Strattum no modo "Espelhar a fonte". Se o seu time precisa dessas reuniões, use o modo "Aberto" e limite o acesso em **Quem pode usar este conector**. ### Quando a identidade não é encontrada * Uma reunião sem anfitrião é gravada sem nenhum leitor. Ela fica invisível no modo "Espelhar a fonte", e os documentos dela não são entregues ao Knowledge, em nenhum dos dois modos. * Quem usa na Strattum um e-mail diferente do que usa no MeetGeek não vê as próprias reuniões no modo "Espelhar a fonte". ### Quando a permissão é atualizada A permissão de uma reunião é recalculada toda vez que o conector relê o detalhe dela: na primeira leitura, quando algum documento está pendente e numa releitura completa. O MeetGeek não muda o anfitrião de uma reunião. Se isso acontecer, a mudança só chega à Strattum numa releitura completa. ## Pré-requisitos * Uma conta no MeetGeek, em qualquer plano com acesso à API. * A região da conta: EU ou US. A chave só vale na região que a emitiu. * A chave de API de um usuário. O conector vê só o universo desse usuário: as reuniões que ele gravou, as compartilhadas com ele e as dos times em que ele pode ver as reuniões dos membros. Ser admin no MeetGeek não amplia esse universo. * Recomendado: uma service account, um usuário MeetGeek dedicado à integração. Convide-o em cada time relevante com permissão de ver as reuniões dos membros, e habilite **Share** para cada membro na regra de compartilhamento do time. Times e compartilhamento por time existem nos planos Business e Enterprise. * Uma só conexão MeetGeek por instalação da Strattum. ## Autenticação e escopos A autenticação usa uma chave de API do MeetGeek, enviada no cabeçalho `Authorization: Bearer ` para o endereço da região escolhida. A chave não tem escopos: ela lê o que o usuário que a gerou lê. O conector só faz leituras. | Escopo ou permissão | Para quê | | - | - | | Acesso do usuário da chave às reuniões | Listar as reuniões, ler o detalhe, a transcrição, o resumo e os highlights. O que o usuário não vê não chega à Strattum | | Permissão de ver as reuniões dos membros de um time | Incluir as reuniões dos colegas que o usuário da chave vê por time | **1. Entre com o usuário do conector** Acesse app.meetgeek.ai com o usuário cuja chave o conector vai usar, de preferência a service account. **2. Gere a chave** Abra **Integrations** e, no card **Public API**, gere a chave. Copie-a. **3. Anote a região** Confira se a conta foi aberta na região EU ou US. Uma chave de conta EU é recusada no endereço US. > [!WARNING] > > A chave dá acesso a todas as reuniões que o usuário vê no MeetGeek. Guarde-a em local seguro e nunca a publique em repositórios. ## Configuração no Console **1. Abra o assistente** Em **Conectores**, crie uma nova conexão e selecione **MeetGeek**. **2. Preencha a conexão** **Nome do Conector** (Opcional): como a conexão aparece na lista. O padrão é `MeetGeek`. **Região** (Obrigatório): "EU (api-eu.meetgeek.ai)" ou "US (api-us.meetgeek.ai)". O padrão é EU. **API Key** (Obrigatório): a chave gerada no card **Public API**. **3. Teste a conexão** Clique em **Testar Conexão**. Você só avança depois de um teste com sucesso. O teste faz uma única requisição: lista uma reunião no endereço da região. Uma conta sem reuniões passa. Se a cota do dia já acabou, o teste passa com um aviso, e você pode salvar. **4. Escolha a frequência** Em **Frequência de Sincronização** (Obrigatório), escolha a frequência. A opção recomendada é "Diário às 06:00 (UTC)". **5. Defina o acesso** Em **Permissionamento**, defina **Quem pode usar este conector** (Obrigatório) e o **Comportamento dos dados** (Obrigatório). O padrão é "Todos os usuários" e "Aberto". **6. Revise e salve** Em **Revisão**, confira os dados e salve. Depois, no Data Catalog, desligue os recursos que você não quer carregar e marque os dados pessoais. Ver [Dados pessoais (PII)](https://docs.strattum.ai/data-pipelines/personal-data.md). Na edição do conector, a chave e a região salvas não aparecem. Para trocar a chave, informe a nova chave e escolha também a região dela, senão o salvamento fica bloqueado. > [!NOTE] > > As transcrições e os resumos só aparecem na busca quando um contexto do Knowledge inclui o conector. O contexto recebe todas as reuniões do MeetGeek, sem recorte por time. ## Como a sincronização funciona A frequência vem do passo **Frequência de Sincronização**. A referência do conector é uma execução por dia, às 06:00 UTC. Rodar mais vezes só gasta a cota mais cedo nos planos Free e Pro. Além dela, roda uma verificação por dia, às 03:00 por padrão, que o conector trata como uma execução normal. **Ordem.** Em cada execução, o conector lê os times da conta e lista todas as reuniões, juntando a listagem do usuário da chave com a de cada time em que ele pode ver as reuniões. Depois busca, nesta ordem: 1. Reuniões novas e reuniões com documento pendente, das mais recentes para as mais antigas. Para cada uma, lê o detalhe e os documentos ligados (transcrição e depois resumo). 2. Reuniões dos últimos 7 dias: só o resumo, para pegar um resumo que mudou ou chegou depois da reunião. 3. Com a cota que sobra, as reuniões mais antigas: só o resumo, começando pela verificação mais antiga. Um resumo verificado há menos de 20 horas não é verificado de novo. Quando o resumo mudou, o conector relê o detalhe e os highlights e reenvia o documento. **Custo.** Cada execução gasta uma requisição com os times, uma para cada 500 reuniões listadas e uma por time. Uma reunião nova custa cerca de 4 requisições: o detalhe, uma por bloco de 500 falas da transcrição, o resumo e os highlights. No plano Free ou Pro, com 100 requisições por dia, isso dá cerca de 20 reuniões novas por dia, e a primeira carga de uma conta grande leva dias. **Paginação.** As listagens e a transcrição são lidas em páginas de 500 itens, seguindo o cursor da API até ele vir vazio. **Cota diária esgotada.** Quando o MeetGeek responde que a cota do dia acabou, o conector para sem erro. A execução termina como concluída, o que não foi buscado fica pendente, e o sync seguinte retoma de onde parou. O log da execução registra o corte e quantas reuniões ficaram pendentes. Se a cota acabar ainda na listagem, nada é buscado e o estado anterior é mantido. **Escrita.** `meetings` é mesclado pelo `meeting_id`: a execução só regrava as reuniões que leu. `teams` é substituído por inteiro em toda execução. Depois da escrita, as tabelas clean são reconstruídas. **Ligar um documento depois.** Se você liga `transcripts` ou `summaries` depois que `meetings` já tem histórico, toda reunião volta a ficar pendente para esse documento. O conector relê o detalhe e busca o documento de todas elas, o que gasta cota e, no plano Free ou Pro, leva dias. **Ligar o Knowledge depois.** Se o conector sincronizou antes de existir um contexto do Knowledge com ele, o Knowledge recusa os documentos dessas execuções. Quando você inclui o conector num contexto, o Knowledge pede uma releitura completa, e o conector busca de novo o detalhe e os documentos de todas as reuniões, com o mesmo custo em cota. **Releitura completa.** Um **Full Refresh** pedido em Data Pipelines marca todas as reuniões como pendentes e relê detalhe e documentos de cada uma. A releitura avança pelo mecanismo normal e, no plano Free ou Pro, termina ao longo de vários dias. É a forma de recuperar um resumo refeito no MeetGeek que a verificação diária não alcançou. **Mudança de dados pessoais.** Quando a marcação de dados pessoais de `meetings` muda no Data Catalog, o conector relê o detalhe de todas as reuniões, sem buscar os documentos de novo. **Reunião inacessível.** Se o MeetGeek recusa o detalhe de uma reunião (resposta 403), ela não é gravada e o conector tenta de novo depois de 20 horas. **Remoção.** Uma reunião apagada no MeetGeek continua na tabela `meetings`. No Knowledge, os documentos dela só saem numa execução completa: uma releitura que revisitou todas as reuniões sem corte de cota, com `transcripts` e `summaries` ligados. No plano Free ou Pro, isso quase nunca acontece. Ver [Atualização e remoção de documentos](https://docs.strattum.ai/data-pipelines/document-updates.md). **Documentos sem conteúdo.** Um resumo ou uma transcrição vazia não vira documento. O resumo vazio continua sendo verificado pela janela de 7 dias e pela verificação das reuniões antigas. A transcrição vazia só é buscada de novo numa releitura completa. Uma falha ao buscar um documento mantém no Knowledge a última versão boa, e o documento fica pendente para a execução seguinte. ## API da fonte Todas as chamadas são `GET` no endereço da região: `https://api-eu.meetgeek.ai` ou `https://api-us.meetgeek.ai`. | Método e caminho | Usado para | Recurso | | - | - | - | | `GET /v1/teams` | Listar os times em que o usuário da chave vê e compartilha reuniões | `teams` | | `GET /v1/meetings` | Listar as reuniões, 500 por página; teste de conexão, com uma reunião | `meetings` | | `GET /v1/teams/{id}/meetings` | Listar as reuniões de cada time em que o usuário vê as reuniões dos membros | `meetings` | | `GET /v1/meetings/{id}` | Ler o detalhe da reunião, com anfitrião, participantes e times | `meetings`, Permissão | | `GET /v1/meetings/{id}/transcript` | Ler a transcrição, 500 falas por página | `transcripts` | | `GET /v1/meetings/{id}/summary` | Ler o resumo e os insights; verificar se o resumo mudou | `summaries` | | `GET /v1/meetings/{id}/highlights` | Ler os highlights | `summaries` | **Rate limits.** O MeetGeek aceita 100 requisições por dia nos planos Free e Pro, e 100 por minuto nos planos Business e Enterprise. A documentação não descreve a resposta ao limite. Na prática, o MeetGeek responde 429 com a unidade do limite (dia ou minuto) no corpo, sem cabeçalho `Retry-After` e sem cabeçalho de cota. O conector envia no máximo 90 requisições por minuto, numa janela móvel, e no máximo 5.000 por execução. Cada requisição espera até 30 segundos. Diante de um 429 de cota diária, ele para a execução sem erro (ver Como a sincronização funciona). Diante de outro 429, repete a mesma chamada depois de 5, 10 e 20 segundos, até 4 tentativas no total. Esgotadas as tentativas, ou numa falha de rede, que não é repetida, a leitura da reunião ou do documento falha e fica pendente para a execução seguinte. Se a falha for na listagem de um time, as reuniões desse time ficam de fora da execução. Se for na leitura dos times ou na listagem principal, a execução inteira falha. Referência oficial: [MeetGeek, Limits](https://docs.meetgeek.ai/api/getting-started/limits.md) ## Limitações conhecidas * Nos planos Free e Pro, com 100 requisições por dia, entram cerca de 20 reuniões novas por dia. A primeira carga de uma conta grande leva dias, e cada execução cortada pela cota aparece como concluída. * A chave vê só o universo do usuário que a gerou. Com a chave de uma pessoa, o conector traz só as reuniões dela e as compartilhadas com ela. Use uma service account convidada nos times. * A permissão é só do anfitrião. Participantes, times e compartilhamentos individuais não dão acesso na Strattum no modo "Espelhar a fonte". * Uma reunião apagada no MeetGeek continua nas tabelas. No Knowledge, os documentos dela só saem numa execução completa, que no plano Free ou Pro quase nunca acontece. * Ligar `transcripts` ou `summaries`, ou incluir o conector num contexto do Knowledge, depois do primeiro sync faz o conector buscar de novo os documentos de todas as reuniões, o que custa cota. * Desligar `transcripts` ou `summaries` impede execuções completas, e documentos de reuniões apagadas não saem do Knowledge. * A transcrição não é relida depois da primeira busca, e uma mudança de anfitrião não é recapturada. As duas só chegam numa releitura completa. * O formato dos times na API não foi confirmado com uma conta real que tenha times. Um time em formato diferente do esperado é pulado, as reuniões que só ele lista ficam de fora, e a execução não se declara completa. Hoje a tabela `meetgeek_teams` costuma ficar vazia. * O link do documento foi confirmado só numa conta EU. Numa conta US, o endereço do app não foi verificado. * Duas pessoas gravando a mesma call geram duas reuniões, e contagens de reuniões podem sair infladas. * Insights por reunião, o download da gravação, o envio de arquivos e os webhooks do MeetGeek não são usados. * O conector não mascara dados pessoais dentro das transcrições e dos resumos. `host_email` e `participant_emails` de `meetings` são sugeridos para mascaramento como e-mail, e `title` como texto livre, no painel de [dados pessoais](https://docs.strattum.ai/data-pipelines/personal-data.md) do Data Catalog. Nada é mascarado até você aplicar a sugestão e salvar. * O MeetGeek não permite vincular a conta de cada usuário: a identidade é o e-mail do anfitrião no MeetGeek. * Cada instalação tem uma só conexão MeetGeek. ## Troubleshooting | Mensagem ou sintoma | Causa | O que fazer | | - | - | - | | A chave de API do MeetGeek é obrigatória. | O campo **API Key** está vazio. | Gere a chave em **Integrations**, no card **Public API**, e cole-a no campo. | | Escolha a região da conta MeetGeek (EU ou US). | A região não foi informada. | Selecione a região em que a conta foi aberta. | | O MeetGeek recusou a chave de API. | A região está errada ou a chave é inválida. | Confira primeiro a região: a chave só vale na região em que foi criada. Se a região estiver certa, gere uma nova chave. | | Chave aceita, mas a cota diária do MeetGeek está esgotada. | As 100 requisições do dia já foram usadas. | Salve o conector. A sincronização avança depois da renovação da cota. | | Chave aceita, mas o limite de requisições do MeetGeek foi atingido. | Limite por minuto atingido durante o teste. | Salve o conector ou teste de novo em alguns instantes. | | Não foi possível contatar a API do MeetGeek. | Falha de rede. | Verifique a conectividade de rede e tente de novo. | | Erro ao verificar a conexão com o MeetGeek (HTTP ``). | O MeetGeek respondeu um erro inesperado. | Tente de novo. Se persistir, contate o suporte do MeetGeek. | | Já existe um conector do tipo meetgeek. | Já há uma conexão MeetGeek nesta instalação. | Edite a conexão existente ou remova-a antes de criar outra. | | A sincronização termina como concluída, mas faltam reuniões. | A cota diária acabou durante a execução. | Aguarde: o sync seguinte retoma as reuniões pendentes. Para cargas grandes, considere um plano Business. | | A sincronização falha. | A leitura dos times ou a listagem de reuniões falhou, por exemplo porque a chave foi revogada. | Teste a conexão na edição do conector e, se preciso, informe uma nova chave com a região dela. | | Reuniões de colegas não aparecem. | A chave é de uma pessoa, ou o usuário da chave não vê as reuniões dos membros do time. | Use uma service account com permissão de ver as reuniões dos membros e **Share** habilitado para cada membro. | | Transcrições e resumos não aparecem na busca. | Nenhum contexto do Knowledge inclui o conector, ou a reunião não tem anfitrião. | Inclua o conector MeetGeek num contexto do Knowledge. | | O resumo de uma reunião recente não aparece. | O MeetGeek ainda processava o resumo, ou a reunião foi curta demais para ter resumo. | Aguarde: reuniões dos últimos 7 dias têm o resumo verificado uma vez por dia. | | Uma pessoa não vê as próprias reuniões no modo "Espelhar a fonte". | O e-mail dela na Strattum é diferente do e-mail no MeetGeek, ou ela não é a anfitriã. | Use o mesmo e-mail nos dois, ou use o modo "Aberto". | ## Próximos passos > **[Data Catalog](https://docs.strattum.ai/data-catalog/overview.md)** > > Escolha os recursos do MeetGeek e marque os dados pessoais. > **[Knowledge](https://docs.strattum.ai/knowledge/overview.md)** > > Veja como as transcrições e os resumos do MeetGeek são indexados e buscados. > **Desenvolvimento local** > > O conector não lê credenciais de variáveis de ambiente. A chave e a região são gravadas por conexão, quando você cria a conexão no Console, com as chaves `MEETGEEK_API_KEY` e `MEETGEEK_REGION` (`eu` ou `us`). Para testar localmente, suba o ambiente pelo [guia de desenvolvimento local](https://docs.strattum.ai/data-pipelines/local-development.md) e crie a conexão pelo Console desse ambiente. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.