Como saber quem compareceu a uma reunião do Clickmax Meet?
Consulte a reunião pela API da Clickmax (/scheduled-calls/get) ou pela ferramenta scheduled_calls_get do MCP. O campo meetParticipants lista cada pessoa que entrou na sala, com o horário de cada entrada e saída e o tempo total. Para reagir na hora, use os gatilhos Participante Entrou na Reunião e Participante Saiu da Reunião ou os eventos de webhook de saída Participante entrou na reunião e Participante saiu da reunião.
Isso vale só para reuniões com sala do Clickmax Meet. Em Google Meet ou link fixo, a sala não é da Clickmax e não há como saber quem entrou.
Antes de começar
- Na call em grupo, a pessoa só fica ligada à própria reunião quando entra pelo link pessoal do lead. Quem entra pelo link genérico da sala aparece na lista só com o nome que digitou.
- Quem só pode ver a própria agenda, ou não alcança as reuniões de um colega, recebe a lista vazia nas reuniões que não alcança, assim como a gravação e o relatório.
Calcule o comparecimento de uma call em grupo
- Escolha a reunião de qualquer inscrito da sessão e consulte
/scheduled-calls/getcom oiddela. - Em
meetParticipants, separe as pessoas comroleigual aguesteidentifiedigual atrue. Cada uma traz oscheduledCallIde oleadIddo inscrito. - Quem é inscrito na sessão e não aparece nessa lista não entrou pelo link pessoal. Pode ter faltado, ou ter entrado pelo link genérico: confira as pessoas com
identifiedigual afalsepelo nome (name).
A lista é a da sala inteira, igual para qualquer inscrito da mesma sessão. Basta consultar uma reunião da turma.
O que cada pessoa traz
role:host(anfitrião) ouguest(convidado).name: o nome exibido na sala.identified:truequando o convidado entrou pelo link pessoal, e sempretruepara o anfitrião, que entra logado. Vemfalsetambém para o convidado de outra reunião da turma que você não alcança.scheduledCallIdeleadId, maisleadEmaileleadPhone: a reunião e o contato do convidado identificado. Vazios para o anfitrião e para quem não foi identificado.userId: o usuário do workspace que entrou como anfitrião.firstJoinedAtelastLeftAt: a primeira entrada e a última saída.sessions: cada entrada (joinedAt) e saída (leftAt), na ordem. Quem saiu e voltou tem mais de uma.leftAtvazio = a pessoa ainda está na sala.connectedSeconds: o tempo total na sala, em segundos.
Receba cada entrada e saída na hora
- Automação: os gatilhos Participante Entrou na Reunião e Participante Saiu da Reunião. Veja Como iniciar uma automação a partir de uma reunião do Clickmax Meet?.
- Webhook de saída: os eventos Participante entrou na reunião e Participante saiu da reunião. O corpo traz a reunião, o contato, o papel, o nome, se foi identificado e o horário do movimento. Veja Webhooks.
Os dois chegam alguns segundos depois do movimento. O webhook pode, raramente, chegar repetido: use o movementId do corpo para descartar repetições.
Se a pessoa não aparece
- Entrou pelo link genérico da call em grupo. Ela aparece só pelo nome digitado, com
identifiedigual afalse. Mande o link pessoal no convite. - A reunião não é do Clickmax Meet. Confira o local da reunião no painel da reunião.
- A pessoa ainda está entrando. A lista mostra a entrada alguns segundos depois de a pessoa entrar na sala.