> ## Documentation Index
> Fetch the complete documentation index at: https://help.cloudtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas do VoiceAgent: Cal.com

> Este exemplo demonstra como configurar duas ferramentas que trabalham em conjunto para gerir a marcação de reuniões através do Cal.com.

<Note>
  Este exemplo demonstra como configurar duas ferramentas que trabalham em conjunto para gerir a marcação de reuniões através do [Cal.com](https://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.
</Note>

**Nível de utilizador:** Admin

***

<h2 id="h_6c37ea78bb">
  Antes de começar
</h2>

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

<h3 id="h_7232ab609f">
  Ferramenta 1: obter os horários disponíveis
</h3>

| **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}}`](https://api.cal.com/v2/slots?username=\&eventTypeSlug=\&start=\&end=) | 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](https://app.cal.com/settings/my-account/profile). |
| | 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. |

<h3 id="h_667269c8a4">
  Ferramenta 2: agendar a reunião
</h3>

| **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`](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](https://app.cal.com/settings/developer/api-keys). |
| **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](https://support.cloudtalk.io/hc/en-us/requests/new?ticket_form_id=26305535257884) — estamos aqui para si.


## Related topics

- [Ferramentas para o VoiceAgent](/pt/articles/11275049-tools-for-voiceagent.md)
- [Acionar uma chamada do VoiceAgent a partir do Zapier](/pt/articles/11831224-triggering-a-voiceagent-call-from-zapier.md)
- [Conformidade com a TCPA nas chamadas de saída dos VoiceAgents](/pt/articles/17230144-tcpa-compliance-for-voiceagent-outbound-calls.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.