Fireflies
Visão geral
Seção intitulada “Visão geral”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.
- Site oficial: https://fireflies.ai
- Documentação na Composio: docs.composio.dev/toolkits/fireflies
Autenticação
Seção intitulada “Autenticação”Esta ferramenta utiliza chave de API (API_KEY) para conectar.
Você vai precisar dos seguintes campos:
| Campo | Obrigatório | Descrição |
|---|---|---|
api_key | Sim | Chave de API gerada no painel do Fireflies.ai em Integrações → Fireflies API. |
Como obter a credencial
Seção intitulada “Como obter a credencial”- Acesse app.fireflies.ai e faça login na sua conta.
- No menu principal, vá até Integrations (Integrações).
- Selecione Fireflies API na lista de integrações disponíveis.
- Copie a chave de API exibida — esse é o valor a usar no campo
api_keyao conectar no SquadOS.
Como conectar no SquadOS
Seção intitulada “Como conectar no SquadOS”- Acesse Ferramentas no menu lateral (
/admin/tools). - Abra a aba Disponíveis e procure por
Fireflies. - Clique no card para abrir o modal de detalhes e em Conectar.
- Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
- 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.)
Ações disponíveis
Seção intitulada “Ações disponíveis”Adicionar à reunião ao vivo
Seção intitulada “Adicionar à reunião ao vivo”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
title | string | Não | Tí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. |
duration | integer | Não | Duração da reunião em minutos. Mínimo de 15 e máximo de 120 minutos. Padrão: 60 minutos. |
language | string | Não | Có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. |
attendees | array | Não | Array de participantes esperados da reunião. |
meeting_link | string | Sim | URL HTTP válida para o link da reunião (ex.: Google Meet, Zoom etc.). |
meeting_password | string | Não | Senha da reunião, se aplicável. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Continuar thread do AskFred
Seção intitulada “Continuar thread do AskFred”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Pergunta ou consulta de acompanhamento para o contexto do thread existente. Máximo de 2000 caracteres. |
thread_id | string | Sim | ID 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_mode | string | Não | Modo de formatação da resposta. Use markdown para formatação rica ou plaintext para texto simples. |
response_language | string | Não | Código de idioma da resposta (ex.: en para inglês, es para espanhol). Padrão: inglês. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar thread do AskFred
Seção intitulada “Criar thread do AskFred”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Sua 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?‘ |
filters | object | Não | Filtros para pesquisar em múltiplas reuniões. |
format_mode | string | Não | Formato da resposta: markdown para formatação rica ou plaintext para texto simples. |
transcript_id | string | Não | ID 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_language | string | Não | Código de idioma da resposta (ex.: en, es, fr). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Criar clipe (bite)
Seção intitulada “Criar clipe (bite)”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
name | string | Não | Nome do clipe. Máximo de 256 caracteres. |
summary | string | Não | Resumo do clipe. Máximo de 500 caracteres. |
end_time | number | Sim | Tempo de fim do clipe em segundos. Deve ser maior que start_time. |
privacies | array | Não | Configurações de visibilidade do clipe. O array pode conter public, team ou participants. |
media_type | string | Não | Tipo de clipe a criar. Deve ser video ou audio. Padrão: video. |
start_time | number | Sim | Tempo de início do clipe em segundos. Deve ser não-negativo e menor que end_time. |
transcript_id | string | Sim | ID da transcrição a partir da qual criar o clipe. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Excluir transcrição por ID
Seção intitulada “Excluir transcrição por ID”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | ID único da transcrição a excluir. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Buscar saídas de aplicativos de IA
Seção intitulada “Buscar saídas de aplicativos de IA”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
skip | integer | Não | Número de registros a pular para paginação. |
limit | integer | Não | Número máximo de saídas de apps a buscar (padrão: 10, máx.: 10). |
app_id | string | Não | Recupera todas as saídas de um Aplicativo de IA específico. Se não fornecido, retorna saídas de todos os apps. |
transcript_id | string | Não | Recupera todas as saídas de uma reunião/transcrição específica. Se não fornecido, retorna saídas de todas as reuniões. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter thread do AskFred
Seção intitulada “Obter thread do AskFred”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador único do thread AskFred a recuperar. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar threads do AskFred
Seção intitulada “Listar threads do AskFred”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
transcript_id | string | Não | Filtra 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. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter clipe por ID
Seção intitulada “Obter clipe por ID”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | ID do clipe a buscar. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar clipes (bites)
Seção intitulada “Listar clipes (bites)”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
mine | boolean | Não | Filtra 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. |
skip | integer | Não | Número de clipes a pular. |
limit | integer | Não | Número máximo de clipes a buscar. |
my_team | boolean | Não | Filtra para incluir clipes da equipe do usuário. Pelo menos um dos parâmetros mine, transcript_id ou my_team deve ser fornecido. |
transcript_id | string | Não | ID da transcrição para buscar os clipes. Pelo menos um dos parâmetros mine, transcript_id ou my_team deve ser fornecido. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter transcrição por ID
Seção intitulada “Obter transcrição por ID”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador único da transcrição a buscar. Apenas chame com IDs cujo status seja completed; transcrições incompletas retornam conteúdo parcial ou ausente. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar transcrições
Seção intitulada “Listar transcrições”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
skip | integer | Não | Número de transcrições a pular. Use com limit para paginação; pare quando a contagem retornada for menor que limit. |
limit | integer | Não | Número máximo de transcrições a buscar. Valor máximo permitido: 50. |
title | string | Não | Título da reunião. Corresponde apenas ao título nos metadados, não ao conteúdo falado. |
to_date | string | Não | Data 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_id | string | Não | ID do usuário cujas transcrições serão buscadas. |
from_date | string | Não | Data 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_email | string | Não | Endereç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. |
organizers | array | Não | Lista de endereços de e-mail de organizadores para filtrar transcrições. |
participants | array | Não | Lista de endereços de e-mail de participantes para filtrar transcrições. |
include_summary | boolean | Não | Se 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_email | string | Não | OBSOLETO: use organizers. E-mail do organizador da reunião. |
include_analytics | boolean | Não | Se deve incluir dados de análise (sentimentos, categorias, estatísticas de locutor) na resposta. Requer plano Pro+. |
include_audio_url | boolean | Não | Se deve incluir o campo audio_url na resposta. Requer plano Pro+. |
include_sentences | boolean | Não | Se 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_url | boolean | Não | Se deve incluir o campo video_url na resposta. Requer plano Business+. |
participant_email | string | Não | OBSOLETO: use participants. E-mail de um participante da reunião. |
include_apps_preview | boolean | Não | Se deve incluir visualização de apps (saídas de apps de IA) na resposta. |
include_user_details | boolean | Não | Se 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_attendees | boolean | Não | Se deve incluir o array detalhado meeting_attendees (nomes de exibição, e-mails, números de telefone) na resposta. |
include_meeting_attendance | boolean | Não | Se deve incluir o array meeting_attendance (timestamps de entrada/saída dos participantes) na resposta. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Obter usuário por ID
Seção intitulada “Obter usuário por ID”FIREFLIES_GET_USER_BY_ID
Busca detalhes associados a um ID de usuário específico.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | ID do usuário cujos detalhes serão buscados. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar grupos de usuários
Seção intitulada “Listar grupos de usuários”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
mine | boolean | Não | Quando 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. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Listar usuários
Seção intitulada “Listar usuários”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).
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Executar consulta GraphQL
Seção intitulada “Executar consulta GraphQL”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
query | string | Sim | Documento de consulta GraphQL (apenas operações somente-leitura). Deve conter apenas operações query. Mutações e subscriptions não são permitidas. |
variables | object | Não | Variáveis GraphQL como objeto JSON. Usadas para passar valores dinâmicos a consultas parametrizadas. |
operationName | string | Não | Nome da operação a executar quando múltiplas operações estão presentes no documento de consulta. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Definir papel do usuário
Seção intitulada “Definir papel do usuário”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
role | string | Sim | Papel a definir para o usuário. Valores válidos: admin (concede privilégios administrativos) e user (permissões de usuário padrão). |
user_id | string | Sim | Identificador único do usuário alvo cujo papel será atualizado. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar canal da reunião
Seção intitulada “Atualizar canal da reunião”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
channel_id | string | Sim | Identificador do canal a atribuir a todas as transcrições especificadas. Uma reunião pode pertencer a apenas um canal por vez. |
transcript_ids | array | Sim | Array 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. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar privacidade da reunião
Seção intitulada “Atualizar privacidade da reunião”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador da transcrição para atualizar as configurações de privacidade. |
privacy | string | Sim | Novo 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). |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Atualizar título da reunião
Seção intitulada “Atualizar título da reunião”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | string | Sim | Identificador único da transcrição de reunião a atualizar. |
title | string | Sim | Novo título a atribuir à transcrição de reunião. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |
Fazer upload de áudio
Seção intitulada “Fazer upload de áudio”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.
Parâmetros de entrada
Seção intitulada “Parâmetros de entrada”| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
url | string | Sim | URL 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. |
title | string | Não | Título ou nome da reunião; será usado para identificar o arquivo transcrito. |
webhook | string | Não | URL do webhook que recebe notificações quando a transcrição é concluída. |
attendees | array | Não | Array 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_video | boolean | Não | Indica se o vídeo deve ser salvo ou não. |
download_auth | object | Não | Detalhes de autenticação para acessar arquivos de mídia protegidos. |
custom_language | string | Não | Código de idioma personalizado para a reunião (ex.: es para espanhol, de para alemão). |
bypass_size_check | boolean | Não | Quando verdadeiro, ignora a validação de tamanho mínimo de 50 KB. Útil para processar arquivos de áudio menores. |
client_reference_id | string | Não | ID de referência do cliente para o participante. |
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
data | string | Sim | Dados retornados pela execução da ação. |
error | string | Não | Mensagem de erro caso a execução tenha falhado. |
successful | boolean | Sim | Indica se a ação foi executada com sucesso. |