Adicione Cal.com ao seu app
Um botão conecta as contas Cal.com dos seus usuários. Depois, seu app lê a disponibilidade deles e agenda em nome deles pela API v2, apenas com os escopos que eles permitirem. Já criou? Liste na App Store do Cal.com.
- See your bookings
BOOKING_READ - Create, reschedule and cancel bookings
BOOKING_WRITE - See your scheduling links
EVENT_TYPE_READ
Usado por empresas em rápido crescimento no mundo todo
Continuar com Cal.com
Os botões oficiais, servidos por app.cal.com. Confira cada um em fundo claro ou escuro, copie como HTML, React, Markdown ou URL e insira seu ID de cliente e URI de redirecionamento.
Do botão ao agendamento
OAuth 2.0 padrão com o fluxo de código de autorização. O botão leva as pessoas para Cal.com, elas escolhem o que seu app pode fazer, e você troca o código por tokens.
- Clientes confidenciais mantêm um segredo no servidor; clientes públicos usam PKCE (S256).
- Tokens de acesso duram 30 minutos; tokens de atualização geram novos tokens.
- Até 10 URIs de redirecionamento exatas por cliente, sem curingas.
- Um token chama apenas os endpoints cobertos pelos seus escopos.
Envie as pessoas para Cal.com
O link do botão. Cal.com mostra a tela de consentimento e redireciona de volta com um código.
1GET https://app.cal.com/auth/oauth2/authorize2 ?client_id=YOUR_CLIENT_ID3 &redirect_uri=https://your-app.com/callback4 &state=YOUR_STATE5 &scope=BOOKING_READ%20BOOKING_WRITE67# de volta ao seu lado8https://your-app.com/callback?code=AUTHORIZATION_CODE&state=YOUR_STATE
Três passos até a App Store
O cliente OAuth conecta seu app às contas das pessoas. A listagem na App Store é como os usuários do Cal.com o encontram.
01
Crie um cliente OAuth
Em Configurações → Desenvolvedor → OAuth, dê um nome ao seu app, escolha pelo menos um escopo e adicione suas URIs de redirecionamento. O cliente começa como pendente; Cal.com o analisa e envia um e-mail para você quando for aprovado.
02
Adicione o botão
Coloque um botão Continuar com Cal.com onde seus usuários conectam ferramentas. Ele abre a tela de consentimento do Cal.com, e seu callback troca o código por tokens.
03
Liste na App Store
Cal.com é de código aberto: crie a listagem do seu app em packages/app-store com yarn create-app, depois abra um pull request em calcom/cal.com. O guia mostra o passo a passo.
Peça apenas o que seu app precisa
As pessoas veem todos os escopos na tela de consentimento antes de permitir, e um token só pode acessar os endpoints cobertos pelos seus escopos.
01
Usuário
A própria conta de uma pessoa: BOOKING_*, EVENT_TYPE_*, SCHEDULE_*, APPS_*, PROFILE_*, WEBHOOK_* e INSIGHTS_READ.
02
Equipe
As equipes às quais pertencem, com os escopos TEAM_*: links de agendamento de equipe, reservas, agendas e associações.
03
Organização
Acesso em toda a organização com os escopos ORG_*. Cada um também concede o escopo TEAM_* correspondente.
Você precisa de agendamento com marca própria dentro do seu app?
Use o coss.com Scheduling, criado pela equipe da Cal.com. A infraestrutura que viabiliza milhões de reservas, com a sua marca e para seus próprios usuários.
coss.scheduling.bookings.create()
const result = await coss.scheduling.bookings.create({ event_type: eventTypeId, start: "2026-03-10T14:00:00Z", attendee: { uid: "customer_77", name: "Sam Lee", email: "[email protected]", time_zone: "America/New_York", }, }); if (result.error?.code === "slot_unavailable") { // Someone got there first: show the times again. }
Trial lesson with Ana Reyes
30 minutes, 10 minute buffer
| Time | Mon 9 | Tue 10 | Wed 11 | Thu 12 | Fri 13 |
|---|---|---|---|---|---|
| 09:00 | busy | open | booked | open | open |
| 10:00 | open | Sam | open | busy | open |
| 11:00 | open | open | busy | open | open |
| 13:00 | booked | open | open | booked | open |
| 14:00 | open | busy | open | booked | open |
| 15:00 | open | busy | open | open | busy |
- confirmedCalendar invitations to Sam and Ana
- scheduling.
booking. confirmed
Dúvidas sobre desenvolver com a Cal.com
As respostas curtas estão aqui. Para qualquer outra coisa, pergunte abaixo.
Faça uma perguntaUm novo cliente fica pendente até a Cal.com analisá-lo. Você recebe um e-mail com o resultado e, depois que ele é aceito, o cliente fica pronto para uso.
Não precisa. Registre-o como um cliente público e use PKCE: envie um code_challenge (S256) ao autorizar e o code_verifier ao trocar o código. Nenhum segredo do cliente é usado.
Os tokens de acesso expiram após 30 minutos. Use o token de atualização para obter um novo sem enviar a pessoa de volta pela tela de consentimento.
Uma chave de API é para sua própria conta Cal.com. OAuth é para agir em contas de outras pessoas, com o consentimento delas e apenas com os escopos que elas permitirem.
Crie a listagem do seu app no repositório de código aberto com yarn create-app em packages/app-store, depois abra um pull request em calcom/cal.com. Dúvidas vão para GitHub Discussions.
É o coss.com Scheduling, infraestrutura de agendamento com marca própria criada pela equipe da Cal.com.
Cal.com Atoms estão em modo de manutenção: integrações existentes continuam recebendo correções e novas versões no npm, mas não haverá novos atoms. A documentação do Atoms continuará no ar.
Conecte seu app à Cal.com
Crie um cliente OAuth, adicione o botão e coloque seu app na frente de todos os usuários da Cal.com.
Criar um cliente OAuthLer a documentação do OAuth