Reuniões

create_meeting

EscritaPede aprovação

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.

Permissão

meetings:write

Operação

meetings.create

As que pedem aprovação não executam na hora: viram um pedido em Para revisar e na aba Aprovações de IA.

Parâmetros

meetingUrlstring (uri)obrigatório

Link do convite (Meet, Zoom ou Teams).

titlestringopcional

joinAtstringopcional

Quando entrar (ISO 8601; sem fuso = Brasília). Sem valor = agora.

languagestringopcional

Idioma da transcrição (padrão pt; auto detecta).ptenesauto

contactIdstringopcional

Contato da reunião (o negócio aberto dele é ligado sozinho).

sendSummaryToParticipantsbooleanopcional

get_meeting

Leitura

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.

Permissão

meetings:read

Operação

meetings.get

Parâmetros

meetingIdstringobrigatório

get_meeting_review

Leitura

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).

Permissão

meetings:read

Operação

meetings.review.get

Parâmetros

meetingIdstringobrigatório

get_meeting_transcript

Leitura

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.

Permissão

meetings:read

Operação

meetings.transcript

Parâmetros

meetingIdstringobrigatório

offsetintegeropcional

limitintegeropcional

Caracteres por parte (padrão 12 mil, cerca de 15 min de conversa).

speakerstringopcional

Parte do nome de quem falou.

link_meeting

Escrita

Liga a reunião a um contato e/ou negócio (o resumo vai para o histórico deles e a análise usa a etapa do negócio). Ligar só o contato liga sozinho o negócio aberto dele; ligar o negócio traz o contato dele. null desfaz.

Permissão

meetings:write

Operação

meetings.link

Parâmetros

meetingIdstringobrigatório

contactIdstringopcional

dealIdstringopcional

list_meetings

Leitura

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.

Permissão

meetings:read

Operação

meetings.list

Parâmetros

querystringopcional

Procura no título, no resumo e nos nomes dos participantes.

statusstringopcional

SCHEDULEDJOININGWAITING_ROOMIN_CALLPROCESSINGCOMPLETEDFAILEDCANCELLED

contactIdstringopcional

dealIdstringopcional

dateFromstringopcional

Início do período (AAAA-MM-DD).

dateTostringopcional

Fim do período (AAAA-MM-DD, inclusivo).

pageintegeropcional

pageSizeintegeropcional

regenerate_meeting_summary

Escrita

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.

Permissão

meetings:write

Operação

meetings.summary.regenerate

Parâmetros

meetingIdstringobrigatório

request_meeting_review

Escrita

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.

Permissão

meetings:write

Operação

meetings.review.request

Parâmetros

meetingIdstringobrigatório

search_meetings

Leitura

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".

Permissão

meetings:read

Operação

meetings.search

Parâmetros

querystringobrigatório

contactIdstringopcional

dealIdstringopcional

dateFromstringopcional

dateTostringopcional

limitintegeropcional

Reuniões (padrão 10).