Môžem volať API volai priamo z frontendového kódu aplikácie?

Nie. API kľúč do prehliadača nepatrí - ktokoľvek, kto otvorí vývojársku konzolu, by ho mohol vidieť a míňať váš kredit. Vždy cez Edge Function alebo iný server route, ktorý kľúč drží iba na backende.

Existuje pre Lovable natívny konektor volai?

Zatiaľ nie - natívne konektory v Lovable sú vždy partnerstvá (tak funguje napríklad ten pre ElevenLabs). Dnes vedie cesta cez REST z Edge Function, prípadne cez všeobecný Custom MCP server opísaný vyššie.

Ako aplikácia pozná, že hovor skončil, bez neustáleho dopytovania?

Webhook call.completed zapíšete do tabuľky Supabase z Edge Function a aplikácia si zmenu prečíta cez Supabase Realtime - žiadny polling.

Koľko bude aplikáciu stáť prevádzka?

Rovnaké sadzby ako v cenníku, žiadny príplatok za Lovable: SMS 1,36 kr (≈ 0,06 EUR), odchádzajúci hovor 0,92 kr/min (≈ 0,04 EUR), hlasový agent navyše 2,50 kr/min (≈ 0,10 EUR). Presný cenník je na /cenik.

REST API

Hlasový agent s českým číslom vo vašej Lovable aplikácii

Lovable stavia aplikácie na Reacte so Supabase backendom - volanie REST API volai preto patrí na server, do jednej Edge Function, nie do aplikácie v prehliadači.

1Uložte API kľúč ako Supabase secret

V projekte Supabase, ktorý Lovable pre aplikáciu založila, pridajte premennú prostredia VOLAI_API_KEY s hodnotou svojho kľúča (portál, sekcia API a MCP). Nikdy ho nedávajte do frontendového kódu ani do repozitára - ktokoľvek, kto by ho videl, by mohol vaším menom míňať kredit.

2Zavolajte volai z Edge Function

Vytvorte Edge Function, ktorá prijme požiadavku z aplikácie a až ONA zavolá https://volai.cz/v1/messages s hlavičkou Authorization: Bearer ${VOLAI_API_KEY}. Rovnako sa dá postaviť funkcia pre POST /v1/calls (hovor cez hlasového agenta).

typescript

// supabase/functions/send-sms/index.ts
Deno.serve(async (req) => {
  const { to, body } = await req.json();

  const res = await fetch("https://volai.cz/v1/messages", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${Deno.env.get("VOLAI_API_KEY")}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ to, body }),
  });

  return new Response(await res.text(), { status: res.status });
});

3Zavolajte funkciu z používateľského rozhrania

Z komponentu aplikácie zavolajte Edge Function cez supabase.functions.invoke(...) - kľúč zostáva len na serveri, aplikácia posiela iba to a text správy.

typescript

const { data, error } = await supabase.functions.invoke("send-sms", {
  body: { to: "+420777123456", body: "Objednavka je pripravena." },
});

4Nastavte webhook, aby aplikácia poznala výsledok hovoru

Založte druhú Edge Function, ktorá prijme udalosť (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) a zapíše ju do tabuľky v Supabase - odtiaľ si ju aplikácia prečíta cez Realtime alebo bežný dopyt. Adresu uložte cez PUT /v1/webhook; prázdne pole events by znamenalo úplne všetky udalosti, radšej ich vymenujte. Supabase v predvolenom stave pustí do Edge Function iba požiadavky s kľúčom v hlavičke Authorization, inak vráti 401: pri tejto funkcii vypnite verify_jwt a udalosť overte podpisom Volai-Signature, alebo kľúč pošlite vo vlastnej hlavičke cez pole headers.

bash

curl -X PUT https://volai.cz/v1/webhook \
  -H "Authorization: Bearer vk_TVUJ_KLIC" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://tvuj-projekt.supabase.co/functions/v1/volai-webhook", "events": ["call.completed", "message.sent"]}'

5Voliteľne: nech si volai vie pridať sama Lovable AI

Lovable vie pri stavbe aplikácie siahnuť aj po cudzom nástroji cez vlastný MCP server (Custom MCP servers / Custom connectors v jej nastavení integrácií). Adresa servera je https://volai.cz/mcp, autentizácia Authorization: Bearer vk_TVUJ_KLIC - presné tlačidlá v UI Lovable sa menia rýchlejšie než táto stránka, aktuálny postup nájdete v docs.lovable.dev/integrations.

Čo s tým urobíte

Potvrdzovacia SMS po objednávke alebo rezervácii

E-shop alebo rezervačná aplikácia z Lovable po zaplatení zavolá vlastnú Edge Function, ktorá pošle potvrdzovaciu SMS s detailmi objednávky.

Hlasový agent, ktorý zdvihne telefón za aplikáciu

Aplikácia kúpi telefónne číslo a založí agenta cez REST (alebo ich nastavíte ručne v portáli) - zákazníci aplikácie potom volajú na skutočné české číslo, nie na cudziu platformu.

Lovable AI si samo pridá volanie a SMS do aplikácie

Pri stavbe aplikácie nechajte Lovable AI siahnuť po volai cez Custom MCP - funkciu opíšete slovami („pridaj tlačidlo, ktoré zavolá zákazníkovi“) a AI si sama vyberie správny nástroj.

Časté otázky

Môžem volať API volai priamo z frontendového kódu aplikácie?: Nie. API kľúč do prehliadača nepatrí - ktokoľvek, kto otvorí vývojársku konzolu, by ho mohol vidieť a míňať váš kredit. Vždy cez Edge Function alebo iný server route, ktorý kľúč drží iba na backende.
Existuje pre Lovable natívny konektor volai?: Zatiaľ nie - natívne konektory v Lovable sú vždy partnerstvá (tak funguje napríklad ten pre ElevenLabs). Dnes vedie cesta cez REST z Edge Function, prípadne cez všeobecný Custom MCP server opísaný vyššie.
Ako aplikácia pozná, že hovor skončil, bez neustáleho dopytovania?: Webhook call.completed zapíšete do tabuľky Supabase z Edge Function a aplikácia si zmenu prečíta cez Supabase Realtime - žiadny polling.
Koľko bude aplikáciu stáť prevádzka?: Rovnaké sadzby ako v cenníku, žiadny príplatok za Lovable: SMS 1,36 kr (≈ 0,06 EUR), odchádzajúci hovor 0,92 kr/min (≈ 0,04 EUR), hlasový agent navyše 2,50 kr/min (≈ 0,10 EUR). Presný cenník je na /cenik.

Vyskúšajte to hneď

Zaregistrujte sa a prvých 50 kr je na nás.

Získať 50 kr kreditu Otvoriť dokumentáciu