Krótka odpowiedź
Tak — ZvonAI udostępnia API dla deweloperów. Za pomocą klucza API (zv_live_…)
odczytasz połączenia, wizyty i statystyki swojego gabinetu, a przez webhooki
zareagujesz na każde zakończone połączenie w czasie rzeczywistym. Dzięki temu
podłączysz ZvonAI do Make, Zapier, n8n albo własnego agenta AI. API v1 jest
tylko do odczytu (klucz nie zmienia danych) i dostępne w planie Business i wyższym.
Do czego służy API ZvonAI?
ZvonAI jest budowane z myślą o erze agentów AI — nie tylko jako panel dla człowieka. API pozwala Ci między innymi:
- Zsynchronizować połączenia z własnym CRM lub arkuszem,
- Zbudować raport dzienny/tygodniowy z liczby połączeń, umówionych wizyt i nieodebranych,
- Uruchomić automatyzację po każdym połączeniu (np. powiadomienie na Slacku, zadanie w Trello),
- Zasilić agenta AI danymi z rozmów, żeby analizował, o co najczęściej pytają pacjenci.
Jak zacząć — klucz API w 4 krokach
- Zaloguj się do panelu → Deweloperzy.
- Kliknij Utwórz klucz API, nazwij go i wybierz uprawnienia (domyślnie tylko odczyt).
- Skopiuj klucz od razu — pokazujemy go tylko raz (przechowujemy wyłącznie hash).
- Trzymaj klucz jak hasło — w zmiennej środowiskowej lub menedżerze sekretów.
Klucz ma format zv_live_… i wysyłasz go w nagłówku:
Authorization: Bearer zv_live_…
Endpointy API v1 (tylko do odczytu)
| Endpoint | Zwraca | Uprawnienie |
|---|---|---|
GET /v1/calls |
listę połączeń (stronicowana) | calls:read |
GET /v1/calls/{id} |
jedno połączenie | calls:read |
GET /v1/appointments |
listę wizyt | appointments:read |
GET /v1/analytics?days=30 |
zbiorcze statystyki połączeń | analytics:read |
Przykład — pobranie ostatnich połączeń:
curl "https://api.zvonai.ai/v1/calls?limit=20" \
-H "Authorization: Bearer zv_live_…"
Odpowiedź zawiera m.in. numer dzwoniącego, status, wynik (booked,
transferred…), czas trwania, sentyment i podsumowanie rozmowy po polsku. Każda
odpowiedź jest ograniczona do Twojego konta — nigdy nie zobaczysz danych innej firmy.
Webhooki — reaguj na każde połączenie
Zamiast odpytywać API co chwilę, możesz odbierać zdarzenia. ZvonAI wysyła webhook
call.completed po każdej zakończonej rozmowie, podpisany HMAC-SHA256.
Konfigurację webhooka włączamy obecnie na życzenie — napisz na support@zvonai.ai;
samodzielna konfiguracja w panelu pojawi się wkrótce.
To najprostszy sposób, by np. automatycznie utworzyć zadanie oddzwonienia, gdy pacjent poprosił o kontakt, albo wysłać podsumowanie rozmowy do zespołu.
Make, Zapier, n8n
Te platformy korzystają z API w standardowy sposób:
- Dodaj moduł HTTP / Webhooks.
- Metoda
GET, adreshttps://api.zvonai.ai/v1/calls(albo/appointments,/analytics). - Nagłówek
Authorization: Bearer zv_live_…. - Wyzwalaj przepływ webhookiem
call.completedi wzbogacaj danymi zGET /v1/calls/{id}.
Pełny przewodnik techniczny (uwierzytelnianie, stronicowanie, limity, przykłady
kodu) znajdziesz w dokumentacji dla deweloperów oraz w schemacie OpenAPI pod
https://api.zvonai.ai/openapi.json.
A co z MCP (Model Context Protocol)?
ZvonAI używa serwerów MCP wewnętrznie w silniku głosowym (kalendarz, Google
Sheets, Excel, CRM, SMS). Nie są one jeszcze hostowanym, zdalnym endpointem, do
którego podłączysz Claude Desktop czy własnego agenta. Hostowany endpoint MCP
(mcp.zvonai.ai) jest w planach — do tego czasu używaj API v1 opisanego wyżej,
bo to wspierany sposób programistycznego dostępu do danych ZvonAI. Piszemy o tym
wprost, bo zależy nam na uczciwej komunikacji.
Najczęstsze pytania (FAQ)
Czy API jest w każdym planie?
Nie — dostęp do API wymaga planu Business lub wyższego. Sprawdź cennik.
Czy klucz API może coś zmienić w moim koncie?
Nie. API v1 jest tylko do odczytu. Zapisy (umawianie/odwoływanie przez API) są
na mapie drogowej i pojawią się za osobnymi uprawnieniami *:write.
Co się stanie, gdy moja subskrypcja wygaśnie?
Dostęp do API zostaje natychmiast wstrzymany do czasu wznowienia subskrypcji.
Czy dane są bezpieczne i zgodne z RODO?
Tak. Dane pozostają w UE (Warszawa, GCP). Więcej w przewodniku o RODO.
Jak unieważnić klucz?
W panelu Deweloperzy klikasz „unieważnij" — działa natychmiast. Zalecamy rotację: utwórz nowy klucz, przełącz integrację, potem unieważnij stary.
Zbuduj na ZvonAI
API zamienia ZvonAI z zamkniętego panelu w platformę, na której budujesz własne automatyzacje i integracje. Zacznij od utworzenia klucza w panelu, a potem sięgnij po dokumentację dla deweloperów.
Zobacz cennik i plan Business → lub przejdź do sekcji dla deweloperów i agentów AI.