Puheagentti tšekkiläisellä numerolla Lovable-sovelluksessasi
Lovable rakentaa sovelluksia Reactilla ja Supabase-taustajärjestelmällä - volain REST API:n kutsut kuuluvat siksi palvelimelle, yhteen Edge Functioniin, eivät selaimessa pyörivään sovellukseen.
1Tallenna API-avain Supabase-secretiksi
Siihen Supabase-projektiin, jonka Lovable loi sovellukselle, lisätään ympäristömuuttuja VOLAI_API_KEY avaimen arvolla (portaali, osio Käyttöoikeus ja API). Älä koskaan lisää sitä frontendin koodiin tai repositorioon - avaimen nähnyt voisi kuluttaa saldosi nimissäsi.
2Kutsu volaita Edge Functionista
Luo Edge Function, joka ottaa vastaan pyynnön sovellukselta ja AINOASTAAN itse kutsuu osoitetta https://volai.cz/v1/messages otsakkeella Authorization: Bearer ${VOLAI_API_KEY}. Samalla tavalla voi rakentaa funktion kutsulle POST /v1/calls (puhelu puheagentin kautta).
// 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 });
});3Kutsu funktiota käyttöliittymästä
Sovelluksen komponentista Edge Functionia kutsutaan funktiolla supabase.functions.invoke(...) - avain pysyy palvelimella ja sovellus lähettää vain to-kentän ja viestin tekstin.
const { data, error } = await supabase.functions.invoke("send-sms", {
body: { to: "+420777123456", body: "Tilaus on valmis." },
});4Määritä webhook, jotta sovellus saa tietää puhelun tuloksen
Luo toinen Edge Function, joka ottaa vastaan tapahtuman (call.completed, call.failed, call.no_answer, call.missed, message.sent, message.received) ja kirjoittaa sen Supabasen taulukkoon - sieltä sovellus lukee sen Realtimen tai tavallisen kyselyn kautta. Tallenna osoite kutsulla PUT /v1/webhook; tyhjä events-kenttä tarkoittaisi ehdottomasti kaikkia tapahtumia, joten luettele ne mieluummin erikseen. Oletuksena Supabase päästää Edge Functioniin vain pyynnöt, joiden otsakkeessa Authorization on avain, ja vastaa muuten 401: poista verify_jwt käytöstä tältä funktiolta ja varmista tapahtuma allekirjoituksella Volai-Signature, tai lähetä avain omassa otsakkeessa kentän headers kautta.
curl -X PUT https://volai.cz/v1/webhook \
-H "Authorization: Bearer vk_SINUN_AVAIMESI" \
-H "Content-Type: application/json" \
-d '{"url": "https://sinun-projektisi.supabase.co/functions/v1/volai-webhook", "events": ["call.completed", "message.sent"]}'5Valinnainen: anna Lovable AI:n lisätä volai itse
Lovable voi sovellusta rakennettaessa tavoittaa ulkoisen työkalun myös oman MCP-palvelimen kautta (Custom MCP servers / Custom connectors integraatioasetuksissa). Palvelimen osoite on https://volai.cz/mcp, todennus Authorization: Bearer vk_SINUN_AVAIMESI - Lovablen käyttöliittymän tarkat painikkeet muuttuvat nopeammin kuin tämä sivu, ajantasainen ohje löytyy osoitteesta docs.lovable.dev/integrations.
Mitä sillä voi tehdä
Vahvistustekstiviesti tilauksen tai varauksen jälkeen
Lovable-verkkokauppa tai varaussovellus kutsuu maksun jälkeen omaa Edge Functioniaan, joka lähettää vahvistustekstiviestin tilauksen tiedoilla.
Puheagentti vastaa puhelimeen sovelluksen puolesta
Sovellus ostaa puhelinnumeron ja luo agentin REST-rajapinnan kautta (tai ne määritetään käsin portaalissa) - sovelluksen asiakkaat soittavat sitten oikeaan tšekkiläiseen numeroon, eivät toiselle alustalle.
Lovable AI lisää puhelut ja tekstiviestit sovellukseen itse
Sovellusta rakennettaessa Lovable AI voi tavoittaa volain Custom MCP:n kautta - toiminto kuvataan sanoin (”lisää painike, joka soittaa asiakkaalle”) ja tekoäly valitsee oikean työkalun itse.
Usein kysyttyä
- Voiko volain API:a kutsua suoraan sovelluksen frontend-koodista?
- Ei. API-avain ei kuulu selaimeen - kehittäjäkonsolin avaava näkisi sen ja voisi kuluttaa saldosi. Kulje aina Edge Functionin tai muun palvelinreitin kautta, joka pitää avaimen vain taustajärjestelmässä.
- Onko Lovablelle sisäänrakennettua volai-yhteyttä?
- Ei vielä - Lovablen sisäänrakennetut yhteydet ovat aina kumppanuuksia (näin toimii esimerkiksi ElevenLabsin yhteys). Tänään reitti kulkee REST-rajapinnan kautta Edge Functionista tai yllä kuvatun yleisen Custom MCP -palvelimen kautta.
- Mistä sovellus tietää puhelun päättyneen ilman jatkuvaa kyselyä?
- Webhook
call.completedkirjoitetaan Supabase-taulukkoon Edge Functionista ja sovellus lukee muutoksen Supabase Realtimen kautta - ei pollausta. - Mitä sovelluksen käyttö maksaa?
- Samat hinnat kuin hinnastossa, ei lisää Lovablesta: tekstiviesti 0,0567 €, lähtevä puhelu 0,0384 €/min, puheagentti lisäksi 0,105 €/min. Tarkka hinnasto löytyy sivulta
/cenik.