Pular para o conteúdo

Fireflies

Fireflies

O Fireflies.ai é um assistente de reuniões baseado em IA que grava, transcreve e resume automaticamente conversas de voz. Ele suporta as principais plataformas de videoconferência e permite pesquisar por palavras-chave em transcrições e extrair pontos de ação. Com a integração no SquadOS, seus agentes podem acessar transcrições de reuniões, criar clipes de áudio, consultar conteúdo por linguagem natural via AskFred e gerenciar usuários da equipe.

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

CampoObrigatórioDescrição
api_keySimChave de API gerada no painel do Fireflies.ai em Integrações → Fireflies API.
  1. Acesse app.fireflies.ai e faça login na sua conta.
  2. No menu principal, vá até Integrations (Integrações).
  3. Selecione Fireflies API na lista de integrações disponíveis.
  4. Copie a chave de API exibida — esse é o valor a usar no campo api_key ao conectar no SquadOS.
  1. Acesse Ferramentas no menu lateral (/admin/tools).
  2. Abra a aba Disponíveis e procure por Fireflies.
  3. Clique no card para abrir o modal de detalhes e em Conectar.
  4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
  5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

FIREFLIES_ADD_TO_LIVE

Adiciona o bot do Fireflies.ai a uma reunião em andamento. Requer um plano pago do Fireflies para adicionar bots a reuniões.

NomeTipoObrigatórioDescrição
titlestringNãoTítulo ou nome da reunião; será usado para identificar o arquivo transcrito. Se não fornecido, um título padrão será definido automaticamente.
durationintegerNãoDuração da reunião em minutos. Mínimo de 15 e máximo de 120 minutos. Padrão: 60 minutos.
languagestringNãoCódigo de idioma da reunião (máx. 5 caracteres). Padrão: en (inglês). Códigos comuns: en, en-US, en-GB, fr, de, es, zh, ja, pt, ar.
attendeesarrayNãoArray de participantes esperados da reunião.
meeting_linkstringSimURL HTTP válida para o link da reunião (ex.: Google Meet, Zoom etc.).
meeting_passwordstringNãoSenha da reunião, se aplicável.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_CONTINUE_ASK_FRED_THREAD

Continua um thread de conversa existente do AskFred com perguntas de acompanhamento. Esta ação NÃO pode criar novos threads — ela funciona apenas com IDs de threads existentes. Use quando precisar manter o contexto de trocas anteriores e fazer perguntas adicionais sobre os dados da reunião na mesma conversa. Para iniciar um novo thread, use FIREFLIES_CREATE_ASK_FRED_THREAD.

NomeTipoObrigatórioDescrição
querystringSimPergunta ou consulta de acompanhamento para o contexto do thread existente. Máximo de 2000 caracteres.
thread_idstringSimID de um thread AskFred existente obtido de uma interação anterior (via FIREFLIES_CREATE_ASK_FRED_THREAD ou FIREFLIES_GET_ASK_FRED_THREADS). Deve ser um ID de thread real — valores como ‘new’ ou ‘latest’ não são válidos.
format_modestringNãoModo de formatação da resposta. Use markdown para formatação rica ou plaintext para texto simples.
response_languagestringNãoCódigo de idioma da resposta (ex.: en para inglês, es para espanhol). Padrão: inglês.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_CREATE_ASK_FRED_THREAD

Inicia um novo thread de conversa do AskFred com uma pergunta sobre reuniões. Use quando precisar consultar transcrições de reuniões em linguagem natural, para uma reunião específica ou em múltiplas reuniões com filtros. Suporta consultas baseadas em tempo e focadas em participantes.

NomeTipoObrigatórioDescrição
querystringSimSua pergunta ou consulta sobre a(s) reunião(ões). Máximo de 2000 caracteres. Exemplos: ‘Quais foram os itens de ação?’, ‘Quem participou da reunião?’, ‘Quais foram os principais tópicos discutidos?‘
filtersobjectNãoFiltros para pesquisar em múltiplas reuniões.
format_modestringNãoFormato da resposta: markdown para formatação rica ou plaintext para texto simples.
transcript_idstringNãoID de uma transcrição/reunião específica para consultar. Se fornecido, o parâmetro filters é ignorado. IDs de transcrição são strings alfanuméricas (ex.: 01JYH3WSWW2DVA72GFPQXC6ST0).
response_languagestringNãoCódigo de idioma da resposta (ex.: en, es, fr).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_CREATE_BITE

Cria um clipe curto de vídeo ou áudio (bite) a partir de um segmento de transcrição. Use quando precisar extrair uma parte específica de uma gravação de reunião com tempos de início e fim definidos.

NomeTipoObrigatórioDescrição
namestringNãoNome do clipe. Máximo de 256 caracteres.
summarystringNãoResumo do clipe. Máximo de 500 caracteres.
end_timenumberSimTempo de fim do clipe em segundos. Deve ser maior que start_time.
privaciesarrayNãoConfigurações de visibilidade do clipe. O array pode conter public, team ou participants.
media_typestringNãoTipo de clipe a criar. Deve ser video ou audio. Padrão: video.
start_timenumberSimTempo de início do clipe em segundos. Deve ser não-negativo e menor que end_time.
transcript_idstringSimID da transcrição a partir da qual criar o clipe.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_DELETE_TRANSCRIPT_BY_ID

Exclui permanentemente uma transcrição da conta Fireflies pelo seu ID único. Esta é uma ação destrutiva e irreversível. A transcrição, junto com seus arquivos de áudio/vídeo e resumos, será removida permanentemente. Limitado a 10 requisições por minuto. Verifique a transcrição alvo via FIREFLIES_GET_TRANSCRIPTS e obtenha confirmação explícita do usuário antes de executar esta ação.

NomeTipoObrigatórioDescrição
idstringSimID único da transcrição a excluir.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_FETCH_AI_APP_OUTPUTS2

Busca saídas de aplicativos de IA para apps ou transcrições específicas. Use quando precisar recuperar resultados gerados por IA dos Aplicativos de IA do Fireflies para reuniões.

NomeTipoObrigatórioDescrição
skipintegerNãoNúmero de registros a pular para paginação.
limitintegerNãoNúmero máximo de saídas de apps a buscar (padrão: 10, máx.: 10).
app_idstringNãoRecupera todas as saídas de um Aplicativo de IA específico. Se não fornecido, retorna saídas de todos os apps.
transcript_idstringNãoRecupera todas as saídas de uma reunião/transcrição específica. Se não fornecido, retorna saídas de todas as reuniões.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_ASK_FRED_THREAD

Obtém um thread de conversa específico do AskFred com o histórico completo. Use quando precisar recuperar um thread AskFred específico com todas as suas mensagens e detalhes da conversa.

NomeTipoObrigatórioDescrição
idstringSimIdentificador único do thread AskFred a recuperar.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_ASK_FRED_THREADS

Recupera um resumo de todos os threads de conversa do AskFred do usuário atual. Use quando precisar navegar ou listar conversas AskFred disponíveis sem buscar o histórico completo de mensagens.

NomeTipoObrigatórioDescrição
transcript_idstringNãoFiltra threads para apenas os associados a um ID de transcrição específico. Se não fornecido, retorna todos os threads do usuário atual.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_BITE_BY_ID

Busca detalhes de um clipe específico pelo ID. Requer um plano Fireflies que suporte Bites e o escopo de API adequado. Se o clipe não for encontrado, use FIREFLIES_GET_TRANSCRIPT_BY_ID para recuperar o contexto completo da transcrição.

NomeTipoObrigatórioDescrição
idstringSimID do clipe a buscar.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_BITES

Busca uma lista de clipes (highlights) conforme os argumentos de entrada. Os clipes são gerados de forma assíncrona após a conclusão da transcrição — chame esta ação apenas depois que FIREFLIES_GET_TRANSCRIPT_BY_ID reportar status=completed. Resultados vazios são possíveis para reuniões válidas; use FIREFLIES_GET_TRANSCRIPT_BY_ID para o contexto completo quando clipes não estiverem disponíveis.

NomeTipoObrigatórioDescrição
minebooleanNãoFiltra para incluir apenas os clipes do próprio usuário. Pelo menos um dos parâmetros mine, transcript_id ou my_team deve ser fornecido.
skipintegerNãoNúmero de clipes a pular.
limitintegerNãoNúmero máximo de clipes a buscar.
my_teambooleanNãoFiltra para incluir clipes da equipe do usuário. Pelo menos um dos parâmetros mine, transcript_id ou my_team deve ser fornecido.
transcript_idstringNãoID da transcrição para buscar os clipes. Pelo menos um dos parâmetros mine, transcript_id ou my_team deve ser fornecido.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_TRANSCRIPT_BY_ID

Busca detalhes de um ID de transcrição específico do Fireflies. Requer um plano pago do Fireflies. A resposta é aninhada em data.outputs.data.transcript; campos como sentences e attendees podem ser nulos — trate-os adequadamente. transcript.summary.action_items pode ser uma string com newlines em vez de um array — divida por quebras de linha ao invés de iterar como array. Limite chamadas concorrentes a ~3 e aplique backoff exponencial em respostas 429, respeitando os cabeçalhos Retry-After.

NomeTipoObrigatórioDescrição
idstringSimIdentificador único da transcrição a buscar. Apenas chame com IDs cujo status seja completed; transcrições incompletas retornam conteúdo parcial ou ausente.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_TRANSCRIPTS

Busca uma lista de transcrições conforme filtros de entrada. Os filtros de metadados (title, host_email, organizers, participants) correspondem apenas aos metadados da transcrição, não ao conteúdo falado. A paginação via skip/limit pode acionar HTTP 429 em requisições rápidas; use backoff entre páginas.

NomeTipoObrigatórioDescrição
skipintegerNãoNúmero de transcrições a pular. Use com limit para paginação; pare quando a contagem retornada for menor que limit.
limitintegerNãoNúmero máximo de transcrições a buscar. Valor máximo permitido: 50.
titlestringNãoTítulo da reunião. Corresponde apenas ao título nos metadados, não ao conteúdo falado.
to_datestringNãoData de fim para filtrar transcrições. Deve estar no formato ISO 8601 com fuso horário (ex.: 2024-08-26T23:59:59Z). Formatos apenas com data não são aceitos.
user_idstringNãoID do usuário cujas transcrições serão buscadas.
from_datestringNãoData de início para filtrar transcrições. Deve estar no formato ISO 8601 com fuso horário (ex.: 2024-08-16T00:00:00Z). Deve ser anterior a to_date. Os filtros são avaliados em UTC — converta intervalos de data locais para UTC para evitar omissões silenciosas.
host_emailstringNãoEndereço de e-mail do host da reunião. Deve ser um endereço de e-mail simples sem marcação ou prefixo mailto:. Exemplo: user@example.com.
organizersarrayNãoLista de endereços de e-mail de organizadores para filtrar transcrições.
participantsarrayNãoLista de endereços de e-mail de participantes para filtrar transcrições.
include_summarybooleanNãoSe deve incluir resumo gerado por IA (itens de ação, palavras-chave, visão geral, notas etc.) na resposta. Pode aumentar significativamente o tamanho da resposta. summary.action_items pode ser uma string formatada em vez de uma lista — divida por newline.
organizer_emailstringNãoOBSOLETO: use organizers. E-mail do organizador da reunião.
include_analyticsbooleanNãoSe deve incluir dados de análise (sentimentos, categorias, estatísticas de locutor) na resposta. Requer plano Pro+.
include_audio_urlbooleanNãoSe deve incluir o campo audio_url na resposta. Requer plano Pro+.
include_sentencesbooleanNãoSe deve incluir o array de sentenças (texto da transcrição com informações de locutor/temporização) na resposta. Pode gerar respostas muito grandes — uma única transcrição pode conter centenas de sentenças.
include_video_urlbooleanNãoSe deve incluir o campo video_url na resposta. Requer plano Business+.
participant_emailstringNãoOBSOLETO: use participants. E-mail de um participante da reunião.
include_apps_previewbooleanNãoSe deve incluir visualização de apps (saídas de apps de IA) na resposta.
include_user_detailsbooleanNãoSe deve incluir informações detalhadas do usuário com user_groups e members aninhados. Quando falso, apenas campos básicos do usuário são retornados.
include_meeting_attendeesbooleanNãoSe deve incluir o array detalhado meeting_attendees (nomes de exibição, e-mails, números de telefone) na resposta.
include_meeting_attendancebooleanNãoSe deve incluir o array meeting_attendance (timestamps de entrada/saída dos participantes) na resposta.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_USER_BY_ID

Busca detalhes associados a um ID de usuário específico.

NomeTipoObrigatórioDescrição
idstringSimID do usuário cujos detalhes serão buscados.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_USER_GROUPS

Busca uma lista de todos os grupos de usuários da equipe com informações sobre os grupos e seus membros. Use quando precisar recuperar grupos de usuários da equipe, opcionalmente filtrando apenas os grupos aos quais o usuário atual pertence com o parâmetro mine.

NomeTipoObrigatórioDescrição
minebooleanNãoQuando verdadeiro, filtra os resultados para retornar apenas os grupos de usuários aos quais o usuário atual pertence. Retorna todos os grupos da equipe quando falso ou omitido.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GET_USERS

Busca uma lista de todos os usuários da equipe, incluindo seus endereços de e-mail completos. Use para resolver endereços de e-mail completos a partir de nomes de usuários antes de passá-los para ferramentas que exigem endereços exatos (sem endereços parciais ou valores somente de domínio).

NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_GRAPHQL_QUERY

Executa uma operação GraphQL autenticada e somente-leitura no Fireflies e retorna a resposta GraphQL bruta completa (data + errors) para fallback confiável e depuração. Use quando ferramentas de nível superior falharem por incompatibilidade de schema ou para acessar detalhes brutos de erros.

NomeTipoObrigatórioDescrição
querystringSimDocumento de consulta GraphQL (apenas operações somente-leitura). Deve conter apenas operações query. Mutações e subscriptions não são permitidas.
variablesobjectNãoVariáveis GraphQL como objeto JSON. Usadas para passar valores dinâmicos a consultas parametrizadas.
operationNamestringNãoNome da operação a executar quando múltiplas operações estão presentes no documento de consulta.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_SET_USER_ROLE

Atualiza o papel de um usuário dentro de uma equipe. Use quando precisar conceder ou revogar privilégios de administrador. Apenas administradores da equipe podem executar esta ação. As equipes devem manter pelo menos um membro administrador a todo momento.

NomeTipoObrigatórioDescrição
rolestringSimPapel a definir para o usuário. Valores válidos: admin (concede privilégios administrativos) e user (permissões de usuário padrão).
user_idstringSimIdentificador único do usuário alvo cujo papel será atualizado.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_UPDATE_MEETING_CHANNEL

Atualiza em lote as atribuições de canal para 1 a 5 transcrições de reuniões. Use quando precisar atribuir reuniões a um canal específico. Requer privilégios de proprietário da reunião ou de administrador da equipe. Semântica tudo-ou-nada: se qualquer transcrição falhar na validação, nenhuma é atualizada.

NomeTipoObrigatórioDescrição
channel_idstringSimIdentificador do canal a atribuir a todas as transcrições especificadas. Uma reunião pode pertencer a apenas um canal por vez.
transcript_idsarraySimArray de IDs de transcrições a atribuir ao canal. Deve conter entre 1 e 5 IDs. Todas as reuniões especificadas devem pertencer a usuários da sua equipe.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_UPDATE_MEETING_PRIVACY

Atualiza a configuração de privacidade de uma transcrição de reunião. Use quando precisar alterar as permissões de acesso à reunião. Apenas proprietários da reunião e administradores da equipe podem atualizar as configurações de privacidade.

NomeTipoObrigatórioDescrição
idstringSimIdentificador da transcrição para atualizar as configurações de privacidade.
privacystringSimNovo nível de privacidade. Valores disponíveis: link (qualquer pessoa com o link pode acessar), owner (apenas o proprietário da reunião), participants (apenas participantes da reunião), teammatesandparticipants (colegas de equipe e participantes), teammates (apenas membros da equipe).
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_UPDATE_MEETING_TITLE

Atualiza o título de uma transcrição de reunião. Use quando precisar renomear uma reunião. Requer privilégios de administrador e o proprietário da reunião deve estar na sua equipe.

NomeTipoObrigatórioDescrição
idstringSimIdentificador único da transcrição de reunião a atualizar.
titlestringSimNovo título a atribuir à transcrição de reunião.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.

FIREFLIES_UPLOAD_AUDIO

Faz upload de arquivos de áudio para o Fireflies.ai para transcrição. A transcrição é assíncrona — após o envio, os resultados podem levar vários minutos para ficarem disponíveis; use as ferramentas de recuperação de transcrição para verificar a conclusão. Requer um plano pago do Fireflies.

NomeTipoObrigatórioDescrição
urlstringSimURL do arquivo de mídia a ser transcrito. Deve ser uma URL HTTPS válida e acessível publicamente. O arquivo de mídia deve estar em um dos seguintes formatos: mp3, mp4, wav, m4a, ogg.
titlestringNãoTítulo ou nome da reunião; será usado para identificar o arquivo transcrito.
webhookstringNãoURL do webhook que recebe notificações quando a transcrição é concluída.
attendeesarrayNãoArray de objetos com informações dos participantes. Relevante se você tiver integrações ativas como Salesforce ou HubSpot. Cada objeto contém: displayName, email, phoneNumber, client_reference_id.
save_videobooleanNãoIndica se o vídeo deve ser salvo ou não.
download_authobjectNãoDetalhes de autenticação para acessar arquivos de mídia protegidos.
custom_languagestringNãoCódigo de idioma personalizado para a reunião (ex.: es para espanhol, de para alemão).
bypass_size_checkbooleanNãoQuando verdadeiro, ignora a validação de tamanho mínimo de 50 KB. Útil para processar arquivos de áudio menores.
client_reference_idstringNãoID de referência do cliente para o participante.
NomeTipoObrigatórioDescrição
datastringSimDados retornados pela execução da ação.
errorstringNãoMensagem de erro caso a execução tenha falhado.
successfulbooleanSimIndica se a ação foi executada com sucesso.