Ferramentas do VoiceAgent: Cal.com - CloudTalk Help Center

Este exemplo demonstra como configurar duas ferramentas que trabalham em conjunto para gerir a marcação de reuniões através do Cal.com. Uma das ferramentas serve para obter os horários disponíveis e a outra para reservar o horário escolhido assim que o cliente confirmar.

Nível de utilizador: Admin

Antes de começar

Antes de começar, certifique-se de que tem:

uma conta ativa no Cal.com e acesso de administrador à mesma
uma subscrição ativa do Recepcionista com IA ou do AI Specialist na sua conta

Ferramenta 1: obter os horários disponíveis

Secção	Campo	Valor	Descrição
Geral	Nome da ferramenta	`get_free_slots`	Descreve o que a ferramenta faz.
	Descrição	Quando o cliente pedir os horários disponíveis, utilize esta ferramenta para obter a lista. A resposta inclui datas e horas em UTC.	Ajuda o LLM a decidir quando chamar esta ferramenta.
	Mensagem de espera de resposta	Vou verificar a disponibilidade. Um momento, por favor.	Mensagem reproduzida enquanto o pedido da ferramenta está a ser processado.
Definição do pedido	Método	`GET`	Método do pedido.
	URL	`https://api.cal.com/v2/slots?username=#{{userName}}&eventTypeSlug=#{{eventType}}&start=#{{startDate}}&end=#{{endDate}}`	URL do endpoint com parâmetros.
Cabeçalhos	cal-api-version	`2024-09-04`	Exigido pelo Cal.com.
	Authorization	`Bearer cal_live_76*REDACTED*17`	Substitua pela sua chave da API do Cal.com.
Parâmetros do caminho	username	Constante: `elise-marshall`	O seu nome de utilizador do Cal.com. Pode ser encontrado no seu perfil.
	eventType	Constante: `30min`	Slug da página de detalhe do evento no Cal.com. Utilize o Prompt do LLM se estiverem disponíveis vários tipos.
	startDate	Parâmetro: `startDate`	Define o início da janela de pesquisa. Deve ser passado como variável do Prompt do sistema.
	endDate	Parâmetro: `endDate`	Define o fim da janela de pesquisa. Também é passado através de uma variável do Prompt do sistema.

Ferramenta 2: agendar a reunião

Secção	Campo	Valor	Descrição
Geral	Nome da ferramenta	`book_meeting`	Nome descritivo da ferramenta.
	Descrição	Esta ferramenta agenda uma reunião no calendário depois de o cliente escolher um horário.	Ajuda o LLM a perceber quando utilizar a ferramenta.
	Mensagem de espera de resposta	Estou a agendar a reunião. Aguarde, por favor.	Mensagem reproduzida enquanto a marcação está em curso.
Definição do pedido	Método	`POST`	Método do pedido.
	URL	`https://api.cal.com/v2/bookings`	Endpoint para agendar uma reunião.
Cabeçalhos	cal-api-version	`2024-08-13`	Conforme exigido pelo Cal.com.
	Authorization	`Bearer cal_live_76*REDACTED*17`	Substitua pela sua chave da API obtida nas definições de API do Cal.com.
Parâmetros do corpo	username	Constante: `elise-marshall`	O seu nome de utilizador do Cal.com.
	eventTypeSlug	Constante: `30min`	Tipo de evento a agendar.
	start	Prompt do LLM: a hora de início da marcação no formato ISO 8601 no fuso horário UTC, por exemplo `2024-08-13T09:00:00Z`.	Extraída da conversa.
	attendee.name	Parâmetro: `name`	Passado através do Prompt do sistema.
	attendee.email	Prompt do LLM: email do cliente que está a agendar a reunião.	Extraído dinamicamente.
	attendee.timezone	Constante ou Prompt do LLM	Definido de acordo com o seu fluxo de trabalho.

Precisa de ajuda ou tem alguma questão? Contacte-nos através do nosso portal de Suporte — estamos aqui para si.