Agendamento
Google Calendar no seu produto e nos seus agentes de IA, por uma API
O toolkit do Google Agenda lista calendários, lista, lê, cria, atualiza e exclui eventos, consulta intervalos ocupados (free/busy) e cria calendários secundários. Pelo Connect, um produto ou agente de IA agenda no calendário do cliente sem construir o fluxo OAuth do Google nem renovar tokens.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/google_calendar_create_event/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"calendarId": "<calendarId>",
"start": {},
"end": {}
}
}Como funciona
Do cliente conectado à primeira chamada no Google Calendar.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Google Calendar. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Google Calendar.
Agendamento a partir do produto
Crie um evento com convidados e link do Google Meet quando um lead marcar uma conversa, um cliente aprovar um post ou uma tarefa ganhar prazo.
Encontrar um horário livre
Deixe um agente de IA ler os intervalos ocupados de um ou mais calendários entre duas datas e propor horários que funcionem.
Um calendário por cliente
Numa ferramenta de agência, crie um calendário secundário para cada cliente, como um calendário de conteúdo, e adicione eventos conforme o trabalho é planejado.
Tools
8 tools do Google Calendar
- Listar calendáriosGETLista os calendários da lista de calendários do usuário. Use o id de um item como calendarId nas ferramentas de evento. O id primary é o calendário principal do usuário.
- Listar eventosGETLista os eventos de um calendário. Defina singleEvents como true para expandir eventos recorrentes, o que é necessário para ordenar por startTime.
- Criar eventoPOSTCria um evento. Use start.dateTime e end.dateTime para um evento com horário, ou start.date e end.date para um evento de dia inteiro. sendUpdates define quem recebe e-mail sobre ele. Um link do Google Meet precisa de conferenceData com conferenceDataVersion 1.
- Obter eventoGETRetorna um evento com os convidados e suas respostas, o link do Meet em hangoutLink e recurringEventId quando é uma instância de um evento recorrente.
- Atualizar eventoPATCHAltera os campos enviados e mantém os outros. Uma lista, como attendees ou recurrence, substitui a lista inteira, então envie todos os convidados que devem ficar. sendUpdates define quem recebe e-mail sobre a mudança.
- Excluir eventoDELETEExclui um evento. O id de um evento recorrente exclui a série inteira; o id de uma instância exclui só ela. sendUpdates define quem recebe e-mail sobre o cancelamento. A resposta é vazia, com status 204.
- Obter free/busyPOSTRetorna os intervalos ocupados de um ou mais calendários entre timeMin e timeMax, em calendars, indexados pelo id do calendário. Um calendário que o usuário não pode ver volta com errors em vez de busy.
- Criar calendárioPOSTCria um calendário secundário do usuário, como um calendário de conteúdo para um cliente. O id da resposta vai em calendarId nas ferramentas de evento.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/google_calendar, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Perguntas sobre o toolkit do Google Calendar
Preciso implementar a API do Google Calendar?
Não. O Connect já traz 8 tools do Google Calendar descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Google Calendar?
Pelo modo que o toolkit aceita: OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Toolkits da mesma categoria
Ver os 100 toolkitsVeja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
