Help Center

O Wave Agents Toolkit: conecte os teus dados a qualquer outra ferramenta

Três formas de levar as tuas gravações do Wave para outras ferramentas: MCP para assistentes de IA, uma REST API para o teu próprio código, e uma CLI para o terminal.

Última atualização:

Tudo o que o Wave AI capta (transcrições, resumos, itens de ação, identificação de interlocutores, ficheiros de áudio e vídeo) pode ser lido fora da app Wave. Wave Agents é o nome para as três formas de o fazer: MCP para assistentes de IA, uma REST API para código que tu escreves, e uma ferramenta de linha de comandos para scripts. Todas as três funcionam com a tua própria conta, usam acesso que tu concedes e podes revogar, e são gratuitas em qualquer plano do Wave.

Escolhe a que corresponde à ferramenta que estás a conectar.

MCP — para assistentes de IA

O Model Context Protocol permite que um assistente de IA consulte a tua biblioteca do Wave durante uma conversa. Claude, ChatGPT, Claude Code, Codex, Cursor, Grok, Muse, Perplexity, e a maioria dos editores de código suportam-no. A configuração é um único URL — https://mcp.wave.co — e um login no browser. Sem código, sem ficheiros de configuração.

Depois de conectado, o assistente pode pesquisar as tuas reuniões por significado, listar sessões recentes, abrir um resumo, obter uma transcrição com identificação de interlocutores, ler itens de ação, e encontrar as sessões em que uma pessoa participou. Também pode:

  • escrever itens de ação de volta numa sessão
  • editar o título, notas, resumo e etiquetas de uma sessão, e marcá-la como favorita
  • criar, renomear e eliminar pastas, colocar uma pasta dentro de outra como subpasta, e arquivar sessões nelas
  • partilhar uma sessão quando pedires
  • importar uma gravação para o Wave, se lhe deres essa permissão separada (ver abaixo)

Não pode eliminar uma sessão nem alterar uma transcrição ou áudio, e eliminar uma pasta nunca elimina as sessões nela contidas. O servidor MCP do Wave tem 23 ferramentas no total; a lista completa está em api.wave.co/mcp.

Podes impedir que um assistente aceda às tuas gravações pessoais limitando os pedidos a uma pasta ou etiqueta. "Usa apenas sessões na minha pasta Trabalho" funciona, porque as ferramentas subjacentes aceitam filtros de pasta e etiqueta. Uma pasta com subpastas inclui as sessões delas, e podes indicar uma subpasta pelo caminho, como "Clientes/Acme". Consulta tudo sobre pastas no Wave.

Guias de configuração: Claude, Claude Code, ChatGPT, Codex, Cursor, Grok, Muse, e outras ferramentas de IA, incluindo o Gemini CLI.

Prompts prontos a usar

O Wave vem com seis prompts que podes usar como ponto de partida em vez de escrever um pedido. Aparecem em ferramentas que suportam prompts MCP: no Claude, abre o menu + numa conversa; no Claude Code, escreve / e procura pelas entradas do Wave.

PromptO que faz
Weekly recapTemas, decisões e itens de ação em aberto nas tuas gravações desde uma data (os últimos 7 dias por predefinição)
Prep for a meetingUm briefing sobre uma pessoa ou tópico a partir das tuas gravações anteriores
Draft a follow-up emailUm resumo, decisões e próximos passos de uma sessão, pronto a enviar
Action items to tasksOs itens de ação de uma sessão, ou de sessões recentes, como uma lista de tarefas organizada
What did someone sayO que uma pessoa disse sobre um tópico, com citações
Decisions logUma lista datada de decisões de uma pasta, ou de sessões desde uma data (os últimos 30 dias por predefinição)

O plugin do Wave para Claude Code e a extensão do Wave para Gemini CLI adicionam os mesmos seis como skills.

Editar sessões

Pede ao assistente para renomear uma sessão, organizar as suas notas, reescrever o seu resumo, alterar as suas etiquetas, ou marcá-la como favorita. Só muda o que pedires. Um novo título ou resumo não pode ser guardado enquanto o Wave ainda está a processar a gravação, porque o processamento o sobrescreveria; o assistente irá avisar-te disso, e podes tentar novamente alguns minutos depois. Notas, etiquetas e favorito podem ser alterados a qualquer momento.

Importar gravações

Um assistente pode adicionar uma gravação ao Wave por ti: a partir de um link para um ficheiro de áudio ou vídeo (por exemplo um episódio de podcast ou um link de download direto), ou, em ferramentas que conseguem carregar um ficheiro local como o Claude Code e o Codex, a partir de um ficheiro no teu computador. O Wave transcreve-o e resume-o depois, como qualquer outra importação.

A importação precisa da sua própria permissão, separada da leitura e escrita. O Wave pede-a num ecrã de consentimento que lista Import recordings into Wave (uses your import allowance) ("Importar gravações para o Wave (usa o teu limite de importação)"). A ferramenta não pode importar nada até marcares I started this connection from [tool] myself ("Fui eu que iniciei esta conexão a partir de [ferramenta]") e selecionares Allow [tool] ("Permitir [ferramenta]"). As importações contam para o mesmo limite de importação que as importações feitas nas apps do Wave. Se a tua ferramenta nunca pedir esta permissão, podes usar em alternativa um token de acesso pessoal com Allow importing recordings ("Permitir importação de gravações") marcado (ver outras ferramentas de IA). O ChatGPT não importa gravações.

Developer API — para código que escreves

Uma REST API em https://api.wave.co/v1, autenticada com um token com âmbito definido que crias nas definições do Wave. Usa-a para sincronizar sessões com um CRM, fazer backup de transcrições, construir um painel, ou alimentar um agente personalizado.

Abrange listagem e filtragem de sessões, resumos, transcrições, itens de ação, pesquisa semântica, pastas, partilha, estatísticas, exportação em massa de até 50 sessões num único pedido, URLs de download assinados para áudio e vídeo, e importação de gravações. Também envia webhooks para o teu servidor assim que uma gravação termina de ser processada, opcionalmente com a transcrição e os itens de ação incluídos, para que nada precise de fazer polling.

Começa aqui: Wave Developer API.

CLI — para o terminal

@waveai/cli instala-se com npm e dá-te um comando wave para scripts, cron jobs e exportações pontuais. Todos os comandos que devolvem dados têm uma flag --json, para se integrarem com o resto da tua shell.

Começa aqui: Wave CLI.

Slack — para perguntar onde a tua equipa já fala

No Slack, pergunta ao Wave sobre as tuas reuniões numa DM, com @Wave numa thread, ou com /wave. As respostas vêm apenas das tuas próprias gravações e permanecem privadas até as partilhares, e o Wave pode publicar um resumo depois de cada gravação.

Começa aqui: Usar o Wave no Slack.

Zapier — para automações sem código

O Zapier dispara um gatilho New Session Ready ("Nova sessão pronta") cada vez que uma sessão termina de ser processada, com o título, resumo, transcrição com identificação de interlocutores, notas e um link. Usa-o para publicar resumos num canal, adicionar linhas a uma folha de cálculo, ou registar uma nota no teu CRM, sem escrever código. O Zapier faz login com a tua conta do Wave, por isso não há nenhum token para gerir.

Começa aqui: Automatizar o Wave com Zapier.

Partilha

Todas as três também funcionam com partilha. Podem ler sessões que outros utilizadores do Wave partilharam contigo, apenas de leitura, e partilhar as tuas próprias sessões: criar um link de convite, enviar convites por email, ver quem tem acesso, e remover pessoas. Um assistente de IA confirma antes de partilhar o que quer que seja. Consulta Partilhar sessões a partir do Claude, ChatGPT, da API e da CLI.

O que estas ferramentas podem e não podem fazer

Nada está conectado até tu o conectares, e cada conexão está limitada à tua própria conta. As únicas gravações de outras pessoas a que pode aceder são sessões que elas escolheram partilhar contigo.

As permissões não são apenas de leitura por predefinição. Quando crias um token de API, marcas exatamente as permissões que queres, e a lista inclui Write sessions and action items ("Escrever sessões e itens de ação"), Delete sessions ("Eliminar sessões"), Manage folders ("Gerir pastas"), e Share sessions and manage access ("Partilhar sessões e gerir acesso"). A importação de gravações é uma permissão separada que nunca está incluída a menos que a escolhas. Iniciar sessão na CLI através do teu browser concede todas as permissões, incluindo eliminar sessões. O MCP é o mais restrito: pode escrever itens de ação, editar sessões, organizar pastas, e partilhar sessões, mas não pode eliminar uma sessão, e só pode importar se tiveres permitido isso.

Concede apenas as permissões de que uma integração realmente precisa. Um token com Delete Sessions ("Eliminar sessões") pode remover gravações permanentemente, e as eliminações via API não se comportam como o lixo dentro da app — consulta Recentemente eliminados.

Revoga o que quiseres a qualquer momento na web. As apps de IA em que iniciaste sessão estão listadas em Settings → Integrations → Connected AI apps ("Definições → Integrações → Apps de IA conectadas"), cada uma com o seu acesso, quando a conectaste, e quando foi usada pela última vez; seleciona Disconnect ("Desconectar") e perde o acesso de imediato. Os tokens de acesso pessoal para ferramentas de IA estão na mesma página em Advanced: personal access tokens ("Avançado: tokens de acesso pessoal"). Os tokens de API e CLI estão em Settings → Developers → API tokens and webhooks ("Definições → Programadores → Tokens de API e webhooks").

Entrega a documentação ao teu assistente de IA

Cada página em api.wave.co tem um botão de cópia no cabeçalho — Copy integration docs ("Copiar documentação de integração"), ou Copy MCP docs ("Copiar documentação MCP") na página do MCP. Copia uma descrição em texto simples de toda a plataforma — endpoints, scopes, formatos de payload, exemplos — que podes colar no Claude ou no ChatGPT e dizer "escreve-me a integração". O mesmo texto está disponível em api.wave.co/llms.txt, e a referência interativa completa está em api.wave.co/reference.

Suporte

Para ajuda com a configuração, usa o chat dentro da app em app.wave.co ou envia um email para support@wave.co. Para questões sobre como construir sobre a API, MCP, ou CLI, api.wave.co é a referência mais completa e mais atualizada.

Este artigo foi útil?

Ainda precisa de ajuda?

E-mail para o suporte

Nesta página