O Calendly oferece opções de incorporação e uma API para ajudar você a incluir agendamento no seu site ou aplicativo. Este artigo explica o que cada ferramenta faz — e quando usá-las.
O que você pode fazer com a API
A API pública do Calendly permite:
- Obtenha seus links de agendamento
- Ver usuários, tipos de eventos e eventos agendados
- Sincronizar a atividade do Calendly com outros sistemas
Com a API, você pode:
- Listar os tipos de eventos de um usuário
- Atualizar um tipo de evento
- Obtenha o link de agendamento para um usuário ou equipe
- Ver detalhes da reunião
- E muito mais
O que você não pode fazer com a API
A API não oferece suporte a:
- Agendar reuniões
- Exibição do fluxo completo de agendamento
Se você quiser que os visitantes agendem com você, use uma incorporação em vez disso.
Quando usar uma incorporação
Use as opções de incorporação quando quiser:
- Mostrar o fluxo de agendamento dentro do seu site ou aplicativo
- Combine a aparência do agendador com a sua marca
- Deixe que os visitantes agendem sem sair da sua página
- Preencha previamente os detalhes do convidado ou use códigos de rastreamento
- Acompanhe agendamentos com ouvintes de eventos (como
calendly.event_scheduled)
Tipos de incorporação:
- Incorporação direta: o agendador é exibido na sua página
- Widget pop-up: um botão flutuante abre o agendador
- Texto de pop-up: um link de texto abre o agendador
Consulte o Guia do Desenvolvedor sobre incorporações do Calendly para saber mais.
Exemplo: Usar API e incorporação
Você pode combinar a API e incorporação para personalizar o agendamento:
- Use a API para obter um link de agendamento.
- Use JavaScript para colocar esse link em sua incorporação.
- Chame
Calendly.initInlineWidget()para carregar o agendador.
Isso permite que você atualize links sem codificá-los.
Quer criar mais?
Nossa equipe está sempre trabalhando para adicionar mais recursos à API.
Verifique se há atualizações em: