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

# Cal.com

> Como configurar a Ação Cal.com em um agente do ChatNorris para que o visitante agende uma reunião sem sair do chat, com o calendário incorporado no widget web, colando apenas o link público do seu tipo de evento.

# Cal.com

Com a Ação Cal.com, o visitante agenda uma reunião com você sem sair do chat. Quando a conversa corresponde ao que você define:

* no **widget web** e no **Playground**, o agente abre o seu calendário do Cal.com incorporado dentro da conversa;
* no **WhatsApp, Instagram, Messenger, Telegram e Email**, o agente compartilha o link direto do evento;
* se o visitante já deixou os dados de contato, o formulário de reserva é pré-preenchido.

Não é preciso conectar nenhuma conta: você só cola o link público do seu tipo de evento.

## Requisitos

* Uma conta do ChatNorris em qualquer plano. O Cal.com está incluído em **todos os planos**, inclusive no Free. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing).
* Pelo menos um agente criado no ChatNorris. Se você ainda não tiver um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md).
* Um tipo de evento (event type) do Cal.com com o seu link público.
* Função **Owner** ou **Admin** na sua organização do ChatNorris.

> [!NOTE]
>
> O Cal.com aparece no catálogo de **Integrações**, na categoria Agenda, mas não requer conexão nem credenciais: ele é configurado diretamente na Ação.

## Configurar a Ação

**1. Crie a Ação Cal.com**

Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Cal.com**.

**2. Cole o link público do seu evento do Cal.com**

Em **Link do evento**, cole a URL pública do seu event type do Cal.com (`cal.com/...` ou `www.cal.com/...`) ou apenas o slug `usuario/evento`. Não é preciso conectar uma conta nem informar credenciais.

**3. Defina quando oferecer o calendário**

Em **Comportamento**, descreva em **Quando usar** em que situações o agente deve oferecer o calendário de reservas. Você pode voltar ao texto original com **Restaurar texto padrão**. O calendário é oferecido sempre que for o caso, a menos que o visitante já tenha feito uma reserva nessa conversa.

**4. Personalize a aparência e as mensagens**

Ajuste o layout e o tema do calendário incorporado, além das mensagens de sucesso e de erro que o visitante vê (veja abaixo).

**5. Habilite a Ação e salve**

Com **Habilitado** ligado, o agente oferece o calendário quando for o caso.

### Aparência do calendário

| Opção | O que faz |
| - | - |
| **Layout** | **Mês (calendário completo)**, **Semana (compacto no chat)** ou **Coluna (compacto)**, que vem por padrão. No chat, Semana e Coluna usam a visualização compacta de dias e horários. |
| **Tema** | **Automático** (por padrão), **Claro** ou **Escuro**. |
| **Ocultar detalhes do evento** | Recomendado no chat (ativado por padrão): oculta título, duração e fuso horário para deixar só os dias e horários. |

Em **Mensagens depois da reserva**, você define a **Mensagem de sucesso** e a **Mensagem de erro** que o visitante vê de acordo com o resultado da reserva.

### Como o visitante agenda

No **widget web** e no **Playground**, o calendário do Cal.com é aberto incorporado dentro da conversa. Nos canais de mensagens (WhatsApp, Instagram, Telegram, Messenger) e no Email, o agente compartilha o link direto do evento. O agente nunca inventa horários nem confirma uma reserva por conta própria: o visitante escolhe o horário e reserva no Cal.com.

> [!TIP]
>
> Se o visitante já deixou os dados de contato antes (por exemplo, em um Lead Form ou durante a conversa), o formulário de reserva do Cal.com é pré-preenchido automaticamente com o nome, o email e o telefone dele.

> [!WARNING]
>
> No **Playground**, as reservas do Cal.com são reais. Se o agente tiver esta Ação, antes da primeira mensagem você verá o aviso **Este teste pode criar dados reais** («Esta prueba puede crear datos reales»). Veja [Testar um agente](https://docs.chatnorris.ai/pt/guias/chatbots.md#testar-um-agente).

### Várias ações de agenda no mesmo agente

Se um agente tiver mais de uma ação de agenda (por exemplo, Cal.com, [Calendly](https://docs.chatnorris.ai/pt/guias/calendly.md) e [Google Calendar](https://docs.chatnorris.ai/pt/guias/google-calendar.md)), ele mostra **um único calendário por resposta**: o que melhor corresponde ao que o visitante pediu. Descreva bem em **Quando usar** que tipo de reunião cada uma cobre para que ele acerte.

Com uma ação de agenda pronta, pedir uma reunião ou uma ligação não é um handoff, mesmo que o visitante mencione um executivo ou consultor: o agente oferece o calendário. Veja [Human Handoff](https://docs.chatnorris.ai/pt/guias/acciones.md#human-handoff).

## Perguntas frequentes

> [accordion] Preciso conectar a minha conta do Cal.com?
>
> Não. Você só precisa do link público do seu tipo de evento. Não são informadas credenciais nem API keys.

> [accordion] O Cal.com está incluído no plano Free?
>
> Sim. A Ação Cal.com está incluída em todos os planos, inclusive no Free.

> [accordion] As reservas do Cal.com não aparecem no Pipedrive
>
> O Cal.com não avisa o ChatNorris sobre a reserva, então o recurso **Registrar reuniões agendadas** do [Pipedrive](https://docs.chatnorris.ai/pt/guias/pipedrive.md) não as registra. Ele só registra os compromissos do Google Calendar, Encuadrado e AgendaPro.


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