Mivicall oferece 4 tiers de integração, do mais simples ao mais profundo. Escolham o que melhor se ajusta às vossas necessidades técnicas.Documentation Index
Fetch the complete documentation index at: https://docs.mivicall.com/llms.txt
Use this file to discover all available pages before exploring further.
Tier 0 — Email forward
A clínica adicionaconfirmacao@mivicall-bridge.{vossopms}.com como reply-to nos emails que enviam. Quando o paciente responde, parseamos texto livre e marcamos a consulta.
Quem deve usar: PMS que não tem API.
Esforço da vossa parte: zero — só configurar reply-to.
Limitações: parsing best-effort, latência ~5 min.
Tier 1 — iCal feed (read-only)
URL.ics standard RFC 5545. Vocês fazem polling (recomendado 5-15 min) e parseiam.
Quem deve usar: integração mais simples, “lemos a agenda como qualquer calendário”.
Esforço: ~2h de código (parser iCal já existe na maioria das linguagens).
Limitações: unilateral (Mivicall → vocês), sem detalhes ricos.
Configurar →
Tier 2 — REST API + Webhooks (recomendado)
Bi-direccional. API keys server-to-server. Webhooks push. Quem deve usar: PMS com developer in-house. Padrão recomendado para 90% dos casos. Esforço: ~1-2 dias para integração completa. Limitações: nenhuma — toda a funcionalidade disponível. Guia PMS →Tier 3 — OAuth 2.0 (multi-tenant)
Para PMS que querem oferecer Mivicall como add-on aos próprios clientes via consent flow. Quem deve usar: vendors com 20+ clínicas-cliente. Esforço: ~1 semana (OAuth flow + token refresh + scopes). Limitações: requer aprovação inicial (registo da aplicação). Estado: em construção — disponível Q3 2026.Matriz de capacidades
| Capacidade | Tier 0 | Tier 1 | Tier 2 | Tier 3 |
|---|---|---|---|---|
| Receber lista marcações | ✓ | ✓ | ✓ | ✓ |
| Tempo real (webhooks) | ✗ | ✗ | ✓ | ✓ |
Marcar attended no check-in | ✗ | ✗ | ✓ | ✓ |
| Criar marcação via PMS | ✗ | ✗ | ✓ | ✓ |
| Cancelar / Reagendar | ✗ | ✗ | ✓ | ✓ |
| Aceder ao histórico de chamadas | ✗ | ✗ | ✓ | ✓ |
| Multi-tenant white-label | ✗ | ✗ | ✗ | ✓ |
| Esforço estimado | <1h | 2h | 1-2 dias | 1 sem |
FAQ — escolher o tier
Não temos developer in-house, queremos só ver as marcações
Não temos developer in-house, queremos só ver as marcações
Tier 1 (iCal). Pedem ao vosso provider de PMS para adicionar um campo “iCal calendar URL” e colam o link. Funciona com qualquer software que aceite calendários externos.
Temos developer e queremos bi-direccional
Temos developer e queremos bi-direccional
Tier 2 (REST + Webhooks). Standard de mercado, mesmo padrão que Stripe/Twilio. 1-2 dias de trabalho. Lê o guia PMS.
Somos vendor de PMS com muitos clientes-clínicas
Somos vendor de PMS com muitos clientes-clínicas
Tier 3 (OAuth). Permite que os vossos clientes activem Mivicall do vosso UI sem ter que partilhar API keys manualmente. Contactem support@mivicall.com para roadmap call.
Queremos algo mais simples que webhooks
Queremos algo mais simples que webhooks
Tier 2 sem webhooks. Façam polling a cada X minutos com
GET /v1/appointments?from=...&updated_since=.... Funciona mas é menos eficiente; recomendamos webhooks quando possível.Suporte
- support@mivicall.com — questões técnicas
- hello@mivicall.com — partnerships / vendor onboarding
- Status page — uptime + incidents