Pierwsze kroki

Quickstart

Najpierw proszę podłączyć asystenta AI lub aplikację i sprawdzić połączenie bez wykonywania rozmów. Potem proszę przejść do zadania, które chcą Państwo załatwić: faktury, terminy, SMS-y, połączenia przychodzące lub własne zadanie.

1Załóż konto

Rejestracja trwa minutę i jest bezpłatna, karta nie jest potrzebna. Po potwierdzeniu adresu e-mail na konto trafia 50.00 CZK (~EUR 2.08) salda - wystarczy to na zakup numeru i kilka rozmów próbnych (SMS-y są dostępne dopiero po pierwszym doładowaniu). Zapomniane hasło można w każdej chwili odzyskać przez link na stronie logowania - zwykłym e-mailem z odnośnikiem do ustawienia nowego.

2Otwórz połączenie asystenta

W portalu proszę otworzyć sekcję Asystent AI i wybrać połączenie przez OAuth. Claude Code, Codex CLI i Codex desktop potrafią otworzyć logowanie; dla innego klienta pozostaje wariant z istniejącym kluczem API.

3Połącz się - MCP lub REST API

MCP podłącza narzędzia volai bezpośrednio do Państwa asystenta. REST API sprawdza się we własnej aplikacji. Obie drogi używają tego samego konta i klucza; obsługiwane akcje i ich ograniczenia znajdą Państwo niżej w mapie możliwości.

Asystent AI przez MCP

Jedno polecenie dla Claude Code (instalacja dla Cursor, Windsurf, VS Code i Claude Desktop jest na stronie Serwer MCP):

claude mcp add --transport http --scope user volai 'https://volai.cz/mcp'
claude mcp login volai

Sprawdź połączenie bez dzwonienia

Proszę wkleić to polecenie do nowego czatu w podłączonym asystencie. Połączenie jest gotowe dopiero po rzeczywistym odczycie tylko do odczytu przez `get_balance` i `list_agents`; do weryfikacji nie trzeba dzwonić, wysyłać SMS-ów ani kupować numeru.

Connect volai as an MCP server at https://volai.cz/mcp using the guide at https://volai.cz/SKILL.md. If it is already connected, use the existing connection. If you can manage MCP in this environment, prepare the configuration; otherwise guide me through the specific steps. Use sign-in through volai, and leave sign-in and consent to me. Do not ask for an API key in chat. Then verify the connection using get_balance and list_agents. Change nothing else, make no calls, send no messages and buy nothing.

Własna aplikacja przez REST API

Klucz można sprawdzić jednym zapytaniem o stan salda:

curl https://volai.cz/v1/balance \
  -H "Authorization: Bearer vk_YOUR_KEY"

{
  "balanceHal": 5000,
  "balanceCzk": 50.00,
  "currency": "CZK"
}

4Opcjonalnie: wybierz dalszą pracę

Po weryfikacji proszę kontynuować zgodnie z celem. Można skorzystać z kreatora, portalu internetowego, REST API lub własnego polecenia MCP; poniższe przykłady są inspiracją, nie obowiązkowym pierwszym zadaniem.

Przykładowe numery i ID proszę zastąpić własnymi. Odpowiedzi poniżej pokazują istotne pola; pełne postaci znajdą Państwo w referencji REST. Przy płatnej akcji proszę użyć tego samego Idempotency-Key do jej powtórzenia, a dla nowej akcji nowego.

Opcjonalnie: wypróbuj głos prawdziwą rozmową

To najszybszy sposób, by usłyszeć volai na własne uszy: jedno żądanie i po kilku sekundach dzwoni Państwa telefon. Bez kupowania numeru, bez zakładania agenta - wystarczy napisać, co ma robić agent, w polu systemPrompt zamiast agentId. Rozmowa wychodzi ze wspólnego numeru demo volai.

curl -X POST https://volai.cz/v1/calls \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_CALL_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+420777123456",
    "systemPrompt": "Jesteś recepcjonistą kawiarni Nula. Przywitaj się, zapytaj, co gość zamawia, i powtórz zamówienie."
  }'

{
  "id": "c_8f2ac1d4x7qz",
  "status": "initiated",
  "trial": true,
  "from": "+420266266641"
}

Opcjonalnie: wyślij SMS-a

Proszę wysłać wiadomość na dowolny czeski lub słowacki numer komórkowy (do innych krajów SMS-ów nie wysyłamy). SMS-y są dostępne dopiero po pierwszym doładowaniu salda, salda powitalnego nie można na nie wykorzystać. Nie należy jednak czekać na odpowiedź - na wspólną nazwę nadawcy SMSinfo odbiorca nie może odpowiedzieć, a numery głosowe volai nie odbierają SMS-ów (odbiór SMS-ów i wysyłanie z własnego numeru umożliwiają dodatek numer komórkowy oraz numer: numer do połączeń i SMS, patrz sekcja Numery komórkowe i sekcja Numer do połączeń i SMS w dokumentacji API):

curl -X POST https://volai.cz/v1/messages \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_SMS_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"to": "+420777123456", "body": "Pozdrowienia od volai! - Moja aplikacja"}'

{
  "id": "msg_7c1f9a2e",
  "status": "sent",
  "priceHal": 136,
  "segments": 1
}

Opcjonalnie: zdobądź numer do połączeń przychodzących

Najpierw numer z wolnej puli - puste ciało {} przypisze numer z domyślnej oferty Praga. Dla konkretnej oferty proszę użyć region albo wybrać e164 przez GET /v1/numbers/available. Zakup od razu pobiera opłatę za pierwszy okres:

curl -X POST https://volai.cz/v1/numbers \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_NUMBER_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "number": {
    "e164": "+420210123456",
    "routing": { "mode": "none", "hasSipPassword": false },
    "monthlyFeeHal": 2500,
    "boughtAt": 1756111640000,
    "region": "praha",
    "regionLabel": "Prague",
    "billingMonths": 1
  }
}

Teraz do tego numeru podpinamy agenta - wystarczy nazwa, prompt systemowy i numer z poprzedniego kroku:

curl -X POST https://volai.cz/v1/agents \
  -H "Authorization: Bearer vk_YOUR_KEY" \
  -H "Idempotency-Key: REPLACE_WITH_UNIQUE_AGENT_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Recepcjonista",
    "systemPrompt": "Jesteś recepcjonistą kawiarni Nula. Przyjmujesz zamówienia na odbiór osobisty i odpowiadasz na pytania o godziny otwarcia (8-18, pn-pt). Nigdy nie wymyślaj cen, których nie znasz. Rozmowę zakończ podsumowaniem zamówienia.",
    "numberE164": "+420210123456"
  }'

{
  "id": "ag_kx91fa2b"
}

I gotowe - proszę zadzwonić na nowy numer. Agent powinien odebrać w ciągu kilku sekund i mówić dokładnie tak, jak Państwo mu napisali w polu systemPrompt.

Mapa możliwości

Przegląd obszarów i dostępnych funkcji. Dla REST i MCP liczba obsługiwanych funkcji jest podana z tych, które dane interfejs oferuje. Celowe wyjątki, na przykład tworzenie dostępu tylko w portalu, wyjaśnia referencja.

Pełna lista znajduje się w referencji REST API oraz na liście narzędzi na stronie MCP .