Preskoči na sadržaj
Preuzmite 50 kr
REST API

Glasovni agent s češkim brojem u vašoj Lovable aplikaciji

Lovable gradi aplikacije na Reactu sa Supabase pozadinom - pozivanje REST API-ja volai zato pripada na poslužitelj, u jedan Edge Function, a ne u aplikaciju u pregledniku.

1Spremite API ključ kao Supabase secret

U projektu Supabase koji je Lovable osnovao za aplikaciju dodajte varijablu okruženja VOLAI_API_KEY s vrijednošću svog ključa (portal, odjeljak API i MCP). Nikada ga ne stavljajte u frontend kod ni u repozitorij - tko god bi ga vidio, mogao bi vašim imenom trošiti stanje.

2Pozovite volai iz Edge Functiona

Izradite Edge Function koji prima zahtjev iz aplikacije i tek ON poziva https://volai.cz/v1/messages sa zaglavljem Authorization: Bearer ${VOLAI_API_KEY}. Na isti se način može izgraditi funkcija za POST /v1/calls (poziv preko glasovnog 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 });
});

3Pozovite funkciju iz korisničkog sučelja

Iz komponente aplikacije pozovite Edge Function preko supabase.functions.invoke(...) - ključ ostaje samo na poslužitelju, a aplikacija šalje samo to i tekst poruke.

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

4Postavite webhook da aplikacija zna ishod poziva

Osnujte drugi Edge Function koji prima događaj (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) i zapisuje ga u tablicu u Supabaseu - odande ga aplikacija čita preko Realtimea ili običnog upita. Adresu spremite preko PUT /v1/webhook; prazno polje events značilo bi baš sve događaje, pa ih radije nabrojite. Supabase u zadanom stanju u Edge Function propušta samo zahtjeve s ključem u zaglavlju Authorization, inače vraća 401: kod ove funkcije isključite verify_jwt i događaj provjerite potpisom Volai-Signature, ili ključ pošaljite u vlastitom zaglavlju preko 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"]}'

5Neobavezno: neka Lovable AI sam doda volai

Lovable pri izradi aplikacije može posegnuti i za tuđim alatom preko vlastitog MCP poslužitelja (Custom MCP servers / Custom connectors u postavkama integracija). Adresa poslužitelja je https://volai.cz/mcp, autentikacija Authorization: Bearer vk_TVUJ_KLIC - točni gumbi u sučelju Lovablea mijenjaju se brže od ove stranice, aktualni postupak pronaći ćete na docs.lovable.dev/integrations.

Što time postižete

Potvrdni SMS nakon narudžbe ili rezervacije

Web-trgovina ili aplikacija za rezervacije iz Lovablea nakon plaćanja poziva vlastiti Edge Function koji šalje potvrdni SMS s detaljima narudžbe.

Glasovni agent koji se javlja na telefon umjesto aplikacije

Aplikacija kupi telefonski broj i osnuje agenta preko REST-a (ili ih ručno postavite u portalu) - korisnici aplikacije tada zovu stvarni češki broj, a ne tuđu platformu.

Lovable AI sam u aplikaciju dodaje pozive i SMS

Pri izradi aplikacije pustite Lovable AI da posegne za volai preko Custom MCP-a - funkciju opišete riječima („dodaj gumb koji zove klijenta“), a AI sam odabere pravi alat.

Česta pitanja

Mogu li API volai pozivati izravno iz frontend koda aplikacije?
Ne. API ključ ne pripada u preglednik - tko god otvori razvojnu konzolu, mogao bi ga vidjeti i trošiti vaše stanje. Uvijek preko Edge Functiona ili drugog poslužiteljskog puta koji ključ drži samo u pozadini.
Postoji li za Lovable nativni konektor volai?
Zasad ne - nativni konektori u Lovableu uvijek su partnerstva (tako radi, primjerice, onaj za ElevenLabs). Danas put vodi preko REST-a iz Edge Functiona, odnosno preko općeg Custom MCP poslužitelja opisanog gore.
Kako aplikacija zna da je poziv završio, bez stalnog propitivanja?
Webhook call.completed zapišete u Supabase tablicu iz Edge Functiona, a aplikacija promjenu čita preko Supabase Realtimea - bez ikakvog pollinga.
Koliko će aplikaciju koštati rad?
Iste cijene kao u cjeniku, bez dodatne naknade za Lovable: SMS 1,36 kr (≈ 0,06 EUR), odlazni poziv 0,92 kr/min (≈ 0,04 EUR), glasovni agent povrh toga 2,50 kr/min (≈ 0,10 EUR). Točan cjenik je na /cenik.

Isprobajte odmah

Registrirajte se i prvih 50 kr dobivate od nas.

Preuzmite 50 kr stanjaOtvori dokumentaciju