# Mivicall

## Docs

- [Cancel appointment](https://docs.mivicall.com/api-reference/appointments/cancel-appointment.md): Equivalente a PATCH com `status: "cancelled"`.
- [Create appointment](https://docs.mivicall.com/api-reference/appointments/create-appointment.md): Criar marcação manualmente (ex: agendada pelo PMS). Usar `Idempotency-Key` header para evitar duplicados em caso de retry.
- [Get appointment](https://docs.mivicall.com/api-reference/appointments/get-appointment.md)
- [List appointments](https://docs.mivicall.com/api-reference/appointments/list-appointments.md): Listar marcações com filtros opcionais.
- [Update appointment](https://docs.mivicall.com/api-reference/appointments/update-appointment.md): Editar marcação. Usos comuns:
- [Get call detail](https://docs.mivicall.com/api-reference/calls/get-call-detail.md): Detalhe da chamada + eventos (transcripts + tool calls + recording).
- [Get recording signed URL](https://docs.mivicall.com/api-reference/calls/get-recording-signed-url.md): Devolve URL pré-assinado para o ficheiro audio em R2. Expira em 24h.
- [List calls](https://docs.mivicall.com/api-reference/calls/list-calls.md): Listagem cursor-paginated, ordenada DESC por startedAt.
- [Healthcheck básico](https://docs.mivicall.com/api-reference/health/healthcheck-básico.md): Liveness probe. Sempre 200 enquanto o serviço estiver up.
- [API Reference](https://docs.mivicall.com/api-reference/introduction.md): Reference completa dos endpoints REST.
- [List professionals](https://docs.mivicall.com/api-reference/professionals/list-professionals.md)
- [List service types](https://docs.mivicall.com/api-reference/services/list-service-types.md)
- [Get current tenant](https://docs.mivicall.com/api-reference/tenant/get-current-tenant.md): Devolve dados da clínica associada à API key.
- [Update tenant config](https://docs.mivicall.com/api-reference/tenant/update-tenant-config.md): Actualizar configuração da clínica (nome, voz, slug público, etc.). Campos não-presentes ficam inalterados.
- [Conceitos](https://docs.mivicall.com/get-started/concepts.md): Modelo de dados core: tenants, profissionais, serviços, marcações, chamadas.
- [Introdução](https://docs.mivicall.com/get-started/introduction.md): Mivicall é uma recepcionista AI para clínicas — atende chamadas, marca consultas e integra-se com o software que já usa.
- [Quickstart](https://docs.mivicall.com/get-started/quickstart.md): Primeira chamada à API Mivicall em 5 minutos.
- [Widget embed](https://docs.mivicall.com/guides/embed-widget.md): 1 linha de HTML para adicionar marcação online ao site da clínica.
- [Integração PMS](https://docs.mivicall.com/guides/pms-integration.md): Guia completo para vendors de Practice Management Systems integrarem com Mivicall.
- [Página pública de booking](https://docs.mivicall.com/guides/public-booking.md): Link Calendly-style para partilhar com pacientes.
- [Google Calendar](https://docs.mivicall.com/integrations/google-calendar.md): Sincronização bi-direccional via OAuth 2.0.
- [Feed iCal](https://docs.mivicall.com/integrations/ical-feed.md): URL .ics standard RFC 5545 — read-only sync com qualquer calendário.
- [Microsoft 365 / Outlook](https://docs.mivicall.com/integrations/outlook.md): Sincronização bi-direccional via Microsoft Graph.
- [Visão geral](https://docs.mivicall.com/integrations/overview.md): Padrões de integração disponíveis.
- [Autenticação](https://docs.mivicall.com/resources/authentication.md): API keys, scopes, e segurança.
- [Errors](https://docs.mivicall.com/resources/errors.md): Códigos de erro HTTP e como tratá-los.
- [Rate limits](https://docs.mivicall.com/resources/rate-limits.md): Limites de uso da API.
- [Versioning](https://docs.mivicall.com/resources/versioning.md): Como gerimos mudanças à API.
- [Eventos](https://docs.mivicall.com/webhooks/events.md): Lista completa de eventos webhook disponíveis.
- [Visão geral](https://docs.mivicall.com/webhooks/overview.md): Mivicall envia eventos para o vosso endpoint em tempo real.
- [Verificar signature](https://docs.mivicall.com/webhooks/signing.md): Como validar HMAC-SHA256 dos webhooks que receberem.

## OpenAPI Specs

- [openapi](https://docs.mivicall.com/api-reference/openapi.json)