## O que é
Uma integração simplesmente fantástica para ligar a sua conta Calendly ao seu Bot Botpress . Envie convites para reuniões aos utilizadores e receba um evento quando eles agendarem diretamente no seu bot.
## Como funciona
Ao ativar a integração, uma assinatura Webhook é criada para sua conta Calendly usando o `Token de acesso` fornecido. Este webhook envia um evento para a integração quando um convidado se inscreve para um dos seus eventos.
A ação `Schedule Calendly Event` pode ser utilizada para criar uma ligação ao evento. Requer um ID da conversa e o URL do evento Calendly . Utiliza o URL para corresponder a um evento do seu Calendly e cria uma nova ligação com o seu Id de Conversa incorporado no interior. Este Id é então usado para ativar o `Calendly Event` dentro da conversa para que o seu bot possa responder ao evento.
O `Conversation Id` é um identificador único para cada conversa. Você pode passar para este campo para incorporar o seu id. Ao receber um evento Calendly você pode usar nas Opções Avançadas o campo `Conversation ID` do `Calendly Event Trigger`. Isto irá puxar o evento para a conversa apropriada.
Você pode ver o código de integração completo em: https://github.com/SimplyGreatBots/Calendly
## Vídeo tutorial
[](https://youtu.be/0jdsGJhoQfo)
Pré-requisitos do ####
A receção de eventos de Calendly requer uma subscrição `Standard` ou superior para ter acesso aos webhooks necessários para esta integração.
#### Calendly Configuração
1. Aceda à sua [Calendly Integrations Page] (https://calendly.com/integrations) e clique em `API and Webhooks`.
2. Clique em `Generate New Token`, escolha um nome e clique em `Create Token`.
3. Depois que o token for criado, copie-o e salve-o em um local seguro. Será necessário na etapa 3 da configuração do Botpress .
#### Botpress Configuração
1. Clique em `Install` no canto superior direito e selecione seu bot.
2. Clique no popup que aparece para configurar a sua integração.
3. Adicione o seu token de acesso Calendly ao campo `Access Token`.
4. Active e guarde a integração.
