Cal.com

​

Antes de começar

• Conta Cal.com com pelo menos um event type. A disponibilidade é a que o Cal.com enxerga, incluindo os calendários conectados a ele (Google, Outlook).
• Brain configurado, com plano que inclui Brain e número dedicado.

​

Quando o Brain usa

​

Passos

curl -X POST https://api.ararahq.com/v1/brain/actions \
  -H "Authorization: Bearer $ARARA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "actionType": "CAL_COM_BOOKING",
    "enabled": true,
    "config": {
      "apiKey": "sua_chave_calcom",
      "eventTypeId": 12345
    }
  }'

​

Fluxo

Cliente:   "Quero marcar uma consulta pra quarta"
  ↓
Brain:     [CAL_COM_BOOKING list_slots date=2026-09-16]
  ↓
Brain:     "Tenho esses horários em quarta 16/09: 10h00, 14h00, 16h00.
            Qual fica melhor pra você?"
  ↓
Cliente:   "10h. Meu nome é Ana, email ana@exemplo.com"
  ↓
Brain:     [CAL_COM_BOOKING book_slot slot_start=2026-09-16T10:00:00-03:00]
  ↓
Brain:     "Agendamento confirmado pra 16/09 às 10h00, Ana.
            Mandei convite pro ana@exemplo.com.
            Pra remarcar/cancelar: <link do Cal.com>"

​

Limitações

• Fuso de Brasília: o dia consultado em list_slots e os horários mostrados usam UTC-3. O agendamento é criado com fuso America/Sao_Paulo.
• Um event type por organização: a Action lê um único eventTypeId.
• Sem remarcação ou cancelamento pela Action: o Brain envia o link de remarcação que o Cal.com devolve; a mudança é feita pelo cliente no Cal.com.
• Email: sem attendee_email, o agendamento é criado com um email interno e o cliente não recebe convite. O Brain é instruído a pedir o email antes.
• Sem cobrança: se o evento exige pagamento, use a Action Stripe ou AbacatePay separadamente.

​

Próximos passos