
Excluir reunião no Zoom, por uma API
Exclui uma reunião. Sem occurrence_id, uma reunião recorrente é excluída com todas as suas ocorrências.
- Identificador
- zoom_delete_meeting
A chamada
POST https://connect.reportei.com/api/tools/zoom_delete_meeting/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"meetingId": 1
}
}Seu sistema envia o id da conexão do cliente e os argumentos da tool. Os headers são os mesmos de toda a API do Connect: o token do seu produto e o token do cliente.
Parâmetros
As descrições dos parâmetros seguem a documentação oficial do app, em inglês.
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| meetingId | integer | Sim | Meeting ID, from List meetings. |
| occurrence_id | string | Não | Deletes only this occurrence of a recurring meeting, from the occurrences in Get meeting. |
| cancel_meeting_reminder | boolean | Não | true emails the registrants about the cancellation. The default is false. |
| schedule_for_reminder | boolean | Não | true emails the host and the alternative hosts about the cancellation. |
Conexões possíveis
O seu cliente conecta a conta do Zoom uma vez, por um dos modos abaixo. A mesma conexão serve para todas as tools do toolkit.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/zoom, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
A resposta
Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app. Erros HTTP retornados pelo app usam o envelope {error, api_error}; falhas de autenticação ou validação podem ocorrer antes da execução. O header X-Toolkit-Execution-Id identifica a execução registrada, consultável em GET /api/tools/executions/{uuid}.
Pronta para agentes de IA
O input desta tool é um JSON Schema, disponível em GET /api/tools/zoom_delete_meeting. Ele vira a definição de tool do seu agente sem conversão.
Outras tools do Zoom
- Obter usuárioGETRetorna o perfil de um usuário: nome, email, fuso horário, ID da reunião pessoal e tipo de plano.
- Listar reuniõesGETLista as reuniões agendadas de um usuário; reuniões instantâneas não são incluídas. A resposta tem meetings e next_page_token: passe next_page_token para ler a próxima página.
- Obter reuniãoGETRetorna uma reunião com join_url, start_url, configurações e, para uma reunião recorrente, suas ocorrências. O start_url expira em duas horas, então leia-o de novo aqui quando precisar.
- Criar reuniãoPOSTAgenda uma reunião para um usuário e a retorna com join_url e start_url. O Zoom aceita até 100 dessas chamadas por dia por anfitrião.
- Atualizar reuniãoPATCHAtualiza uma reunião; só os campos enviados mudam. Com occurrence_id, altera uma ocorrência de uma reunião recorrente. O Zoom aceita até 100 atualizações por dia por reunião.
- Obter convite da reuniãoGETRetorna o texto do convite de uma reunião, com o link e os dados de discagem, pronto para enviar aos convidados.
- Listar inscritos na reuniãoGETLista os inscritos de uma reunião com inscrição ativada. Só os inscritos aprovados voltam, a menos que status diga outra coisa. Exige plano Pro ou superior. Passe next_page_token para ler a próxima página.
- Inscrever participante na reuniãoPOSTInscreve uma pessoa em uma reunião com inscrição ativada e retorna o registrant_id e o join_url pessoal. O Zoom pode enviar email ao inscrito, conforme as configurações da reunião.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
