Blog

Dando poder a um marketplace de agendamento

Sydney OlejnikNov 16, 2022

Um marketplace de agendamento: o que isso quer dizer? Como usamos isso?

A Cal.com foi criada para dar poder ao seu marketplace de agendamento, mas muita gente fica confusa quando ouve as palavras “marketplace de agendamento.”

O que exatamente quer dizer dar poder a um marketplace de agendamento?

O cenário ideal para qualquer empresa é que um cliente permaneça no próprio site e não seja redirecionado para outro site para fazer qualquer ação. A infraestrutura de agendamento da Cal.com torna isso fácil para as organizações conseguirem.

A melhor forma de explicar isso por completo é usando um exemplo.

Digamos que você escolheu usar as APIs da Cal.com para dar poder ao marketplace de agendamento do seu negócio. Como isso se parece? Tudo começa quando um cliente se cadastra na sua plataforma novinha em folha, que vamos chamar de BestDogSitting. Quando o cliente cria uma conta na BestDogSitting, essa conta também é criada na Cal.com via API (Single Sign On); o cliente então pode adicionar suas disponibilidades, que são puxadas para a plataforma da Cal.com via API, e depois pode selecionar as páginas de evento que quiser. À medida que a Cal.com cresce e adiciona mais APIs, os dois lados se beneficiam da infraestrutura sólida.

Com a infraestrutura de agendamento da Cal.com, a BestDogSitting também consegue criar componentes de UI de front-end e, usando um dos nossos mais de 40+ endpoints de API, enviar esses dados de e para a plataforma da Cal.com, criando assim uma experiência de agendamento nativa para os clientes sem precisar reconstruir toda a solução de agendamento. Se tem uma coisa que nossa equipe aprendeu, é que agendamento e fusos horários são extremamente difíceis e dão muito mais trabalho do que a maioria dos engenheiros imagina.

De onde veio tudo isso? A resposta é simples: Lean Hire.

Lean Hire é um marketplace de contratação criado originalmente pelo nosso CEO, Peer Richelsen. Quando usava o Lean Hire, as organizações tinham a opção de contract-to-hire como período de teste com seus possíveis candidatos, em vez de ir com tudo logo de cara. A ideia foi amplamente usada na OnDeck (onde acabou sendo adquirida) e ainda é usada como a principal forma de integrar novos membros à equipe na Cal.com também.

Com o Lean Hire, toda vez que um novo usuário era criado, o candidato precisava adicionar o próprio link do Calendly ou o Peer precisava criar manualmente uma nova conta para ele. Essa não era a melhor experiência porque tirava a pessoa do site do Lean Hire, e o Peer não tinha dados nem controle sobre o que estava acontecendo no outro lado.

À medida que entrou no modo de resolver problemas, o Peer percebeu que precisava de um produto de agendamento que pudesse ser totalmente incorporado ao site ou tivesse APIs robustas para basicamente automatizar tarefas como criar um novo usuário, criar Scheduling links, criar disponibilidades e muito mais.

Ok, isso é interessante, mas o que tudo isso quer dizer?

Dar poder completo a um marketplace de agendamento exige automação forte feita por meio de APIs. Essas APIs dão a capacidade de criar toda a experiência de agendamento para que as empresas pareçam nativas, como se tivessem criado isso por conta própria.

A Cal.com resolve amplamente essa solução. À medida que continuamos crescendo e adicionando mais APIs, nosso produto Platform se torna mais poderoso e, além disso, as organizações podem fazer self-hosting para ter acesso a todos os dados do início ao fim. Qualquer org pode executar vários tipos diferentes de consultas para entender o que seus usuários estão fazendo. Isso atualmente não é possível com outros produtos e é algo específico do que a Cal.com oferece. Com Cal, as organizações podem ter controle total dos seus dados para atender melhor às suas necessidades.

On-Premise

O produto Platform também é um dos poucos produtos on-premise oferecidos. On-premise significa que as organizações podem fazer self-hosting dos seus dados nos próprios servidores. Fazendo self-hosting, as organizações têm controle total dos dados dos usuários. Com esse controle holístico, as empresas podem usar os dados dos usuários como quiserem. Além disso, isso oferece muito mais controle e segurança para elas.

Isso é incrível; como posso usar isso para beneficiar meu negócio?

Quando você faz self-hosting com a Cal.com, cria a capacidade de começar a retomar o controle dos seus dados. Isso é melhor feito por meio dos nossos poderosos endpoints de API com o produto Platform. Para mostrar algumas ideias do que pode ser feito, aqui estão alguns dos nossos endpoints de API mais populares até agora:

Endpoints de API [CRUD]:

Participantes

Disponibilidades

Referências de reserva

Reservas

Entradas personalizadas

Calendários de destino

Referências de evento

Scheduling links

Associações

Pagamentos

Agendas

Calendários selecionados

Teams

Usuários

Webhooks

Aqui estão alguns exemplos de como usar esses endpoints de API:

API de Scheduling Link

Nossas APIs podem ser personalizadas e adaptadas para atender exatamente às suas necessidades. Abaixo estão alguns exemplos de customizações atuais e em uso.

Para criar um novo Scheduling link, você poderia fazer algo assim:

[POST] : htttps://www.example.com/api/v1/event-types?apiKey=1234abcd

Parâmetros brutos do corpo:

{

    "userId": 4,

    "title": "Tennis class",

    "slug": "tennis-class-{{$guid}}",

    "length": 60,

    "hidden": false,

    "position": 0,

    "teamId": null,

    "eventName": null,

    "timeZone": null,

    "periodType": "UNLIMITED",

    "periodStartDate": null,

    "periodEndDate": null,

    "periodDays": null,

    "periodCountCalendarDays": null,

    "requiresConfirmation": true,

    "recurringEvent": {

        "interval": 2,

        "count": 10,

        "freq": 2

    },

    "disableGuests": false,

    "hideCalendarNotes": false,

    "minimumBookingNotice": 120,

    "beforeEventBuffer": 0,

    "afterEventBuffer": 0,

    "schedulingType": null,

    "price": 0,

    "currency": "usd",

    "slotInterval": null,

    "successRedirectUrl": null,

    "description": null,

    "locations": [

        {

            "address": "London",

            "type": "inPerson"

        }

    ],

    "metadata": {}

}

Para obter todos os Scheduling links, você poderia fazer algo assim:

[GET] : htttps://www.example.com/api/v1/event-types?apiKey=1234abcd

Para ATUALIZAR/PATCH um link de agendamento individual, você pode fazer algo assim:

[PATCH] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

onde :id é o ID do event-type (numérico)

Parâmetros Raw do Corpo:

{

    "title": "Aula de futebol",

     ...other_changes

}

Para EXCLUIR um link de agendamento individual, você pode fazer algo assim:

[DELETE] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

onde :id é o ID do event-type (numérico)

Para obter um tipo de evento individual, você pode fazer algo assim:

[GET] : htttps://www.example.com/api/v1/event-types/:id?apiKey=1234abcd

onde :id é o ID do event-type (numérico)

A Cal.com é a principal solução de agendamento que prioriza a sua capacidade de impulsionar um marketplace de agendamento. Estamos aqui para ajudar você a tornar sua organização bem-sucedida.

Quer começar? Confira nossa documentação aqui: https://developer.cal.com/api/quick-start 

Cal.com agora é GRATUITO para indivíduos - cadastre-se aqui

Sydney Olejnik

Post by

Sydney Olejnik

Administrative Coordinator