Preskoči na vsebino
Prejmite 50 kr
REST API

Glasovni agent s češko številko v vaši aplikaciji Lovable

Lovable gradi aplikacije na Reactu s Supabase v ozadju - klicanje REST API-ja volai zato sodi na strežnik, v eno funkcijo Edge Function, ne v aplikacijo v brskalniku.

1Ključ API shranite kot skrivnost Supabase

V projektu Supabase, ki ga je Lovable ustvaril za vašo aplikacijo, dodajte spremenljivko okolja VOLAI_API_KEY z vrednostjo svojega ključa (portal, razdelek API in MCP). Nikoli ga ne dajte v kodo frontenda ali v repozitorij - kdor bi ga videl, bi lahko v vašem imenu porabljal dobroimetje.

2Pokličite volai iz funkcije Edge Function

Ustvarite Edge Function, ki sprejme zahtevo iz aplikacije in šele ONA pokliče https://volai.cz/v1/messages z glavo Authorization: Bearer ${VOLAI_API_KEY}. Na enak način lahko zgradite funkcijo za POST /v1/calls (klic prek glasovnega 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 });
});

3Pokličite funkcijo iz uporabniškega vmesnika

Iz komponente aplikacije pokličite Edge Function prek supabase.functions.invoke(...) - ključ ostane samo na strežniku, aplikacija pošlje le to in besedilo sporočila.

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

4Nastavite webhook, da aplikacija izve rezultat klica

Ustvarite drugo Edge Function, ki sprejme dogodek (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) in ga zapiše v tabelo v Supabase - od tam ga aplikacija prebere prek Realtime ali običajne poizvedbe. Naslov shranite prek PUT /v1/webhook; prazno polje events bi pomenilo čisto vse dogodke, zato jih raje naštejte. Supabase privzeto spusti v Edge Function le zahteve s ključem v glavi Authorization, sicer vrne 401: pri tej funkciji izklopite verify_jwt in dogodek preverite s podpisom Volai-Signature ali pa ključ pošljite v lastni glavi prek polja 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"]}'

5Neobvezno: naj volai doda Lovable AI sam

Lovable lahko pri gradnji aplikacije poseže tudi po tujem orodju prek lastnega strežnika MCP (Custom MCP servers / Custom connectors v nastavitvah integracij). Naslov strežnika je https://volai.cz/mcp, overjanje Authorization: Bearer vk_TVUJ_KLIC - natančni gumbi v uporabniškem vmesniku Lovable se spreminjajo hitreje kot ta stran, aktualen postopek najdete na docs.lovable.dev/integrations.

Kaj lahko z njim naredite

Potrditveni SMS po naročilu ali rezervaciji

Spletna trgovina ali rezervacijska aplikacija iz Lovable po plačilu pokliče lastno Edge Function, ki pošlje potrditveni SMS s podrobnostmi naročila.

Glasovni agent, ki namesto aplikacije dvigne telefon

Aplikacija kupi telefonsko številko in prek REST ustvari agenta (ali ga ročno nastavite v portalu) - stranke aplikacije nato kličejo resnično češko številko, ne tuje platforme.

Lovable AI si sam doda klicanje in SMS v aplikacijo

Pri gradnji aplikacije pustite, da Lovable AI poseže po volai prek Custom MCP - funkcijo opišete z besedami (»dodaj gumb, ki pokliče stranko«), AI pa sam izbere pravo orodje.

Pogosta vprašanja

Ali lahko API volai pokličem neposredno iz kode frontenda aplikacije?
Ne. Ključ API ne sodi v brskalnik - kdor bi odprl razvijalsko konzolo, bi ga lahko videl in porabljal vaše dobroimetje. Vedno prek Edge Function ali druge strežniške poti, ki ključ hrani samo v zaledju.
Ali za Lovable obstaja izvorni konektor volai?
Zaenkrat ne - izvorni konektorji v Lovable so vedno partnerstva (tako deluje na primer tisti za ElevenLabs). Danes vodi pot prek REST iz Edge Function ali prek splošnega strežnika Custom MCP, opisanega zgoraj.
Kako aplikacija izve, da se je klic končal, brez nenehnega spraševanja?
Webhook call.completed zapišete v tabelo Supabase iz Edge Function, aplikacija pa spremembo prebere prek Supabase Realtime - brez pollinga.
Koliko bo stalo delovanje aplikacije?
Enake cene kot v ceniku, brez doplačila za Lovable: SMS 1,36 kr (≈ 0,06 EUR), odhodni klic 0,92 kr/min (≈ 0,04 EUR), glasovni agent dodatno 2,50 kr/min (≈ 0,10 EUR). Točen cenik je na /cenik.

Preizkusite takoj

Registrirajte se in prvih 50 kr je na naš račun.

Prejmite 50 kr dobroimetjaOdpri dokumentacijo