Skip to content
CognizyCognizyHelp
Sign in
In this area

Meetings

9 tools

create_meeting

WriteNeeds approval

Manda o bot do Cognizy gravar e transcrever uma reunião (Google Meet, Zoom ou Teams): agora ou num horário. Gasta minutos/créditos do plano pelo tempo gravado. Vinda de chave de API ou de agente, NÃO executa na hora: vira pedido na fila de aprovação e só acontece quando um administrador aprova. Avise que está aguardando aprovação.

Permission
meetings:write
Operation
meetings.create

Tools that wait for approval don't run right away: they become a request in To review and in the AI approvals tab.

Parameters

meetingUrlstring (uri)required
Link do convite (Meet, Zoom ou Teams).
titlestringoptional
joinAtstringoptional
Quando entrar (ISO 8601; sem fuso = Brasília). Sem valor = agora.
languagestringoptional
Idioma da transcrição (padrão pt; auto detecta).ptenesauto
contactIdstringoptional
Contato da reunião (o negócio aberto dele é ligado sozinho).
sendSummaryToParticipantsbooleanoptional

get_meeting

Read

Uma reunião: resumo, tarefas combinadas (com responsável), participantes, contato e negócio ligados e a nota da análise. A transcrição não vem aqui (é longa): use get_meeting_transcript.

Permission
meetings:read
Operation
meetings.get

Parameters

meetingIdstringrequired

get_meeting_review

Read

Análise da call comercial pelo playbook da empresa: nota 0–100, notas por etapa (abertura, descoberta, valor, objeções, próximo passo), fala × escuta, critérios de qualificação, objeções com a fala sugerida, próximo passo e momentos bons e a melhorar. status NONE = ainda não analisada (request_meeting_review).

Permission
meetings:read
Operation
meetings.review.get

Parameters

meetingIdstringrequired

get_meeting_transcript

Read

Transcrição de uma reunião, em linhas "Nome: fala", em partes de até 30 mil caracteres. Comece em offset 0 e siga com nextOffset enquanto não for null. `speaker` deixa só as falas de uma pessoa.

Permission
meetings:read
Operation
meetings.transcript

Parameters

meetingIdstringrequired
offsetintegeroptional
limitintegeroptional
Caracteres por parte (padrão 12 mil, cerca de 15 min de conversa).
speakerstringoptional
Parte do nome de quem falou.

list_meetings

Read

Reuniões gravadas pelo bot do Cognizy (Meet, Zoom, Teams, Discord), mais recentes primeiro: título, data, duração, participantes, contato/negócio ligados, se já tem resumo e a nota da análise da call. Para o conteúdo use get_meeting; para achar o que foi dito, search_meetings.

Permission
meetings:read
Operation
meetings.list

Parameters

querystringoptional
Procura no título, no resumo e nos nomes dos participantes.
statusstringoptional
SCHEDULEDJOININGWAITING_ROOMIN_CALLPROCESSINGCOMPLETEDFAILEDCANCELLED
contactIdstringoptional
dealIdstringoptional
dateFromstringoptional
Início do período (AAAA-MM-DD).
dateTostringoptional
Fim do período (AAAA-MM-DD, inclusivo).
pageintegeroptional
pageSizeintegeroptional

regenerate_meeting_summary

Write

Refaz o resumo e a lista de tarefas combinadas a partir da transcrição guardada (quando o resumo saiu ruim); não cria tarefas no quadro de novo. Roda em segundo plano: confira com get_meeting em seguida.

Permission
meetings:write
Operation
meetings.summary.regenerate

Parameters

meetingIdstringrequired

request_meeting_review

Write

Analisa a call agora (ou de novo) pelo playbook de vendas. Custa 1 crédito. Roda em segundo plano: confira com get_meeting_review depois de um ou dois minutos.

Permission
meetings:write
Operation
meetings.review.request

Parameters

meetingIdstringrequired

search_meetings

Read

Procura uma palavra ou frase no que foi falado nas reuniões (e nos resumos), sem acento e sem caixa. Devolve, por reunião, as falas que batem com quem falou e a fala anterior. Ex.: "reajuste", "prazo de entrega".

Permission
meetings:read
Operation
meetings.search

Parameters

querystringrequired
contactIdstringoptional
dealIdstringoptional
dateFromstringoptional
dateTostringoptional
limitintegeroptional
Reuniões (padrão 10).

All tools