Siirry sisältöön
REST API

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).

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 });
});

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.

typescript
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.

bash
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.completed kirjoitetaan 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.

Kokeile heti

Rekisteröidy, niin saat ensimmäiset 2 € meiltä.